WebRequest 类

定义

public ref class WebRequest abstract

public ref class WebRequest abstract : MarshalByRefObject, System::Runtime::Serialization::ISerializable

public abstract class WebRequest

public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable

[System.Serializable]
public abstract class WebRequest : MarshalByRefObject, System.Runtime.Serialization.ISerializable

type WebRequest = class

type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

[<System.Serializable>]
type WebRequest = class
    inherit MarshalByRefObject
    interface ISerializable

Public MustInherit Class WebRequest

Public MustInherit Class WebRequest
Inherits MarshalByRefObject
Implements ISerializable

继承

Object

WebRequest

继承

Object

MarshalByRefObject

WebRequest

派生

System.IO.Packaging.PackWebRequest

System.Net.FileWebRequest

System.Net.FtpWebRequest

System.Net.HttpWebRequest

属性

SerializableAttribute

实现

ISerializable

示例

以下示例演示如何创建 WebRequest 实例并返回响应。

using System;
using System.IO;
using System.Net;
using System.Text;

namespace Examples.System.Net
{
    public class WebRequestGetExample
    {
        public static void Main ()
        {
            // Create a request for the URL. 		
            WebRequest request = WebRequest.Create ("http://www.contoso.com/default.html");
            // If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials;
            // Get the response.
            HttpWebResponse response = (HttpWebResponse)request.GetResponse ();
            // Display the status.
            Console.WriteLine (response.StatusDescription);
            // Get the stream containing content returned by the server.
            Stream dataStream = response.GetResponseStream ();
            // Open the stream using a StreamReader for easy access.
            StreamReader reader = new StreamReader (dataStream);
            // Read the content.
            string responseFromServer = reader.ReadToEnd ();
            // Display the content.
            Console.WriteLine (responseFromServer);
            // Cleanup the streams and the response.
            reader.Close ();
            dataStream.Close ();
            response.Close ();
        }
    }
}

Imports System.IO
Imports System.Net
Imports System.Text

Namespace Examples.System.Net
    Public Class WebRequestGetExample

        Public Shared Sub Main()
            ' Create a request for the URL. 		
            Dim request As WebRequest = WebRequest.Create("http://www.contoso.com/default.html")
            ' If required by the server, set the credentials.
            request.Credentials = CredentialCache.DefaultCredentials
            ' Get the response.
            Dim response As HttpWebResponse = CType(request.GetResponse(), HttpWebResponse)
            ' Display the status.
            Console.WriteLine(response.StatusDescription)
            ' Get the stream containing content returned by the server.
            Dim dataStream As Stream = response.GetResponseStream()
            ' Open the stream using a StreamReader for easy access.
            Dim reader As New StreamReader(dataStream)
            ' Read the content.
            Dim responseFromServer As String = reader.ReadToEnd()
            ' Display the content.
            Console.WriteLine(responseFromServer)
            ' Cleanup the streams and the response.
            reader.Close()
            dataStream.Close()
            response.Close()
        End Sub
    End Class
End Namespace

注解

WebRequest 是 abstract 基类。用于从 Internet 访问数据的请求/响应模型。 使用请求/响应模型的应用程序可以采用与协议无关的方式从 Internet 请求数据，应用程序可在协议特定的子代类执行请求的详细信息时处理 WebRequest 类的实例。

请求从应用程序发送到特定的 URI，例如服务器上的网页。 URI 确定从为应用程序注册的 WebRequest 后代列表创建的正确后代类。 WebRequest 后代通常注册为处理特定协议（例如 HTTP 或 FTP），但可以注册以处理对服务器上的特定服务器或路径的请求。

当访问 Internet 资源时出错时，WebRequest 类将引发 WebException。 Status 属性是指示错误源的 WebExceptionStatus 值之一。 当 StatusWebExceptionStatus.ProtocolError时，Response 属性包含从 Internet 资源收到的 WebResponse。

由于 WebRequest 类是 abstract 类，因此运行时 WebRequest 实例的实际行为由 Create 方法返回的子代类决定。 有关默认值和异常的详细信息，请参阅子代类的文档，例如 HttpWebRequest 和 FileWebRequest。

实施者说明

从 WebRequest继承时，必须重写以下成员：Method、RequestUri、Headers、ContentLength、ContentType、Credentials、PreAuthenticate、GetRequestStream()、BeginGetRequestStream(AsyncCallback, Object)、EndGetRequestStream(IAsyncResult)、GetResponse()、BeginGetResponse(AsyncCallback, Object)和 EndGetResponse(IAsyncResult)。 此外，必须提供 IWebRequestCreate 接口的实现，该接口定义调用 Create(Uri)时使用的 Create(Uri) 方法。 必须使用 RegisterPrefix(String, IWebRequestCreate) 方法或配置文件注册实现 IWebRequestCreate 接口的类。

另请参阅

• HttpWebRequest
• 请求数据
• 可插入协议编程