WebRequest.Create 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
初始化新的 WebRequest。
重载
Create(String) |
已过时。
为指定的 URI 方案初始化新的 WebRequest 实例。 |
Create(Uri) |
已过时。
为指定的 URI 方案初始化新的 WebRequest 实例。 |
Create(String)
注意
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。
返回
特定 URI 方案的 WebRequest 子代。
- 属性
例外
requestUriString
中指定的请求方案尚未注册。
requestUriString
为 null
。
调用方没有连接到请求的 URI 或请求重定向到的 URI 的 WebPermissionAttribute 权限。
requestUriString
中指定的 URI 不是有效的 URI。
注意:在用于 Windows Store 应用或可移植类库的 .NET 中,FormatException请改为捕获基类异常。
示例
以下示例用于 Create 实例化 HttpWebRequest 实例。 表示目标 URL 的字符串用作构造函数参数。
Uri^ ourUri = gcnew 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();
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返回者Create。requestUri``https://
如果以传递开头 ftp://
的 URI,该方法 Create 将返回一个 FtpWebRequest 实例。 如果以传递开头 file://
的 URI,该方法 Create 将返回一个 FileWebRequest 实例。
已注册的预注册预留类型包括:
http://
https://
ftp://
file://
.NET includes support for the http://
, https://
, ftp://
, and file://
URI schemes. 使用该方法注册用于处理其他请求的RegisterPrefix自定义WebRequest后代。
该方法 Create 使用 requestUriString
参数创建 Uri 传递给新 WebRequest实例的实例。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅.NET Framework中的网络跟踪。
另请参阅
适用于
Create(Uri)
注意
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
参数
返回
指定的 URI 方案的 WebRequest 子代。
- 属性
例外
requestUri
中指定的请求方案未注册。
requestUri
为 null
。
调用方没有连接到请求的 URI 或请求重定向到的 URI 的 WebPermissionAttribute 权限。
示例
以下示例用于 Create 实例化 HttpWebRequest 实例。 表示目标 URL 的 URI 用作构造函数参数。
// Create a new 'Uri' object with the specified string.
Uri^ myUri = gcnew 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.
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
项。
例如,如果创建子代处理程序 1,以处理请求http://www.contoso.com/text/
和另一WebRequest个命名 Handler2 来处理请求http://www.contoso.com/code/
,则可以使用Create方法返回与任一指定 URI 关联的 WebRequest 后代。
若要仅基于 URI 的方案部分返回类的 WebRequest 后代,请使用 CreateDefault 该方法。
例如,当 URI 以或传入开头http://
时,HttpWebRequest返回者Create。requestUri``https://
如果以传递开头 ftp://
的 URI,该方法 Create 将返回一个 FileWebRequest 实例。 如果以传递开头 file://
的 URI,该方法 Create 将返回一个 FileWebRequest 实例。
已注册的预注册预留类型包括:
http://
https://
ftp://
file://
.NET includes support for the http://
, https://
, ftp://
, and file://
URI schemes. 使用该方法注册用于处理其他请求的RegisterPrefix自定义WebRequest后代。
备注
当你在应用程序中启用网络跟踪后,此成员将输出跟踪信息。 有关详细信息,请参阅.NET Framework中的网络跟踪。