WebRequest.Create 方法

定义

命名空间:: System.Net

程序集:: System.dll, System.Net.Requests.dll

程序集:: netstandard.dll, System.Net.Requests.dll

程序集:: System.Net.Requests.dll

程序集:: System.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化新的 WebRequest。

重载

名称	说明
Create(String)	已过时. 初始化指定 URI 方案的新 WebRequest 实例。
Create(Uri)	已过时. 初始化指定 URI 方案的新 WebRequest 实例。

Create(String)

Source:: WebRequest.cs

Source:: WebRequest.cs

Source:: WebRequest.cs

Source:: WebRequest.cs

Source:: WebRequest.cs

注意

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

初始化指定 URI 方案的新 WebRequest 实例。

public:
 static System::Net::WebRequest ^ Create(System::String ^ requestUriString);

public static System.Net.WebRequest Create(string requestUriString);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create(string requestUriString);

static member Create : string -> System.Net.WebRequest

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : string -> System.Net.WebRequest

Public Shared Function Create (requestUriString As String) As WebRequest

参数

requestUriString: String

标识 Internet 资源的 URI。

WebRequest

WebRequest特定 URI 方案的后代。

属性: ObsoleteAttribute

例外

NotSupportedException

尚未注册中指定的 requestUriString 请求方案。

ArgumentNullException

requestUriString 是 null。

SecurityException

调用方无权 WebPermissionAttribute 连接到请求的 URI 或请求重定向到的 URI。

UriFormatException

中指定的 requestUriString URI 不是有效的 URI。

示例

以下示例用于 Create 实例化 HttpWebRequest 实例。表示目标 URL 的字符串用作构造函数参数。

Uri ourUri = new Uri(url);            

// Create a 'WebRequest' object with the specified url. 
WebRequest myWebRequest = WebRequest.Create(url); 

// Send the 'WebRequest' and wait for response.
WebResponse myWebResponse = myWebRequest.GetResponse(); 

// Use "ResponseUri" property to get the actual Uri from where the response was attained.
if (ourUri.Equals(myWebResponse.ResponseUri))
    Console.WriteLine("\nRequest Url : {0} was not redirected",url);   
else
    Console.WriteLine("\nRequest Url : {0} was redirected to {1}",url,myWebResponse.ResponseUri);   
// Release resources of response object.
myWebResponse.Close();


Dim ourUri As New Uri(url)
' Create a 'WebRequest' object with the specified url. 

Dim myWebRequest As WebRequest = WebRequest.Create(url)

' Send the 'WebRequest' and wait for response.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

' "ResponseUri" property is used to get the actual Uri from where the response was attained.
If ourUri.Equals(myWebResponse.ResponseUri) Then
    Console.WriteLine(ControlChars.Cr + "Request Url : {0} was not redirected", url)
Else
    Console.WriteLine(ControlChars.Cr + "Request Url : {0} was redirected to {1}", url, myWebResponse.ResponseUri)
End If 

' Release resources of response object.
myWebResponse.Close()

注解

该方法 Create 返回在运行时确定的 WebRequest 类的子代，作为最近的注册匹配 requestUri项。

例如，当 URI 以或传入开头http://时，会返回一个 HttpWebRequest 。CreaterequestUrihttps:// 如果改为传递以开头 ftp:// 的 URI，该方法 Create 将返回一个 FtpWebRequest 实例。如果改为传递以开头 file:// 的 URI，该方法 Create 将返回一个 FileWebRequest 实例。

已注册的预留类型包括：

http://
https://
ftp://
file://

.NET 包括对 > 和 URI 方案的支持。用于处理其他请求的WebRequest自定义RegisterPrefix后代注册到该方法。

该方法 Create 使用 requestUriString 参数创建 Uri 传递给新 WebRequest实例的实例。

注释

在应用程序中启用网络跟踪时，此成员将输出跟踪信息。有关详细信息，请参阅 .NET Framework 中的 Network Tracing。

另请参阅

编程可插入协议

适用于

Create(Uri)

Source:: WebRequest.cs

Source:: WebRequest.cs

Source:: WebRequest.cs

Source:: WebRequest.cs

Source:: WebRequest.cs

注意

WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.

初始化指定 URI 方案的新 WebRequest 实例。

public:
 static System::Net::WebRequest ^ Create(Uri ^ requestUri);

public static System.Net.WebRequest Create(Uri requestUri);

[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.WebRequest Create(Uri requestUri);

static member Create : Uri -> System.Net.WebRequest

[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member Create : Uri -> System.Net.WebRequest

Public Shared Function Create (requestUri As Uri) As WebRequest

参数

requestUri: Uri

Uri包含所请求资源的 URI。

WebRequest

WebRequest指定 URI 方案的后代。

属性: ObsoleteAttribute

例外

NotSupportedException

未注册中指定的 requestUri 请求方案。

ArgumentNullException

requestUri 是 null。

SecurityException

调用方无权 WebPermissionAttribute 连接到请求的 URI 或请求重定向到的 URI。

示例

以下示例用于 Create 实例化 HttpWebRequest 实例。表示目标 URL 的 URI 用作构造函数参数。

// Create a new 'Uri' object with the specified string.
Uri myUri =new Uri("http://www.contoso.com");
// Create a new request to the above mentioned URL.	
WebRequest myWebRequest= WebRequest.Create(myUri);
// Assign the response object of 'WebRequest' to a 'WebResponse' variable.
WebResponse myWebResponse= myWebRequest.GetResponse();

' Create a new 'Uri' object with the specified string.
Dim myUri As New Uri("http://www.contoso.com")
' Create a new request to the above mentioned URL.	
Dim myWebRequest As WebRequest = WebRequest.Create(myUri)
'  Assign the response object of 'WebRequest' to a 'WebResponse' variable.
Dim myWebResponse As WebResponse = myWebRequest.GetResponse()

注解

该方法 Create 返回在运行时确定的 WebRequest 类的子代，作为最近的注册匹配 requestUri项。

例如，如果创建 WebRequest 子代 Handler1，以处理对 http://www.contoso.com/text/ 请求的请求和另一个命名 Handler2 来处理请求 http://www.contoso.com/code/，则可以使用 Create 方法返回与任一指定 URI 关联的 WebRequest 后代。

若要仅基于 URI 的方案部分返回类的 WebRequest 子代，请使用 CreateDefault 该方法。

例如，当 URI 以或传入开头http://时，会返回一个 HttpWebRequest 。CreaterequestUrihttps:// 如果改为传递以开头 ftp:// 的 URI，该方法 Create 将返回一个 FileWebRequest 实例。如果改为传递以开头 file:// 的 URI，该方法 Create 将返回一个 FileWebRequest 实例。