语言

WebRequest.Create 方法

定义

初始化新的 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特定 URI 方案的后代。

特性

例外

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

requestUriString 是 null。

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

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

注意:在 Windows Store 应用的 .NET 或 Portable 类库中,请改为捕获基类异常,FormatException。

示例

以下示例用于 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://时,会返回一个 https:// 。requestUriHttpWebRequestCreate 如果改为传递以开头 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指定 URI 方案的后代。

特性

例外

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

requestUri 是 null。

调用方无权 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://时,会返回一个 https:// 。requestUriHttpWebRequestCreate 如果改为传递以开头 ftp:// 的 URI,该方法 Create 将返回一个 FileWebRequest 实例。 如果改为传递以开头 file:// 的 URI,该方法 Create 将返回一个 FileWebRequest 实例。

已注册的预留类型包括:

  • http://

  • https://

  • ftp://

  • file://

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

注释

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

适用于