WebRequest.Create 方法

定義

命名空間:

System.Net

組件:

netstandard.dll, System.Net.Requests.dll

初始化一個新的 WebRequest。

多載

名稱	Description
Create(String)	已淘汰. 初始化 WebRequest 指定 URI 方案的新實例。
Create(Uri)	已淘汰. 初始化 WebRequest 指定 URI 方案的新實例。

Create(String)

來源:

WebRequest.cs

警告

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

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

public:
 static System::Net::WebRequest ^ Create(System::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);

[<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

識別網際網路資源的 URI。

傳回

WebRequest

這是 WebRequest 特定URI方案的後裔。

屬性

ObsoleteAttribute

例外狀況

NotSupportedException

該 requestUriString 請求方案尚未註冊。

ArgumentNullException

requestUriString 為 null。

SecurityException

呼叫者無 WebPermissionAttribute 權連接請求的 URI 或請求被重定向的 URI。

UriFormatException

該 URI requestUriString 並非有效的 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

例如，當一個以 http:// 或 https:// 開頭的 URI 傳遞至 requestUri時，會 HttpWebRequest 被 Create返回 。 如果傳遞以 URI ftp:// 開頭的 URI，該 Create 方法將回傳一個 FtpWebRequest 實例。 如果傳遞以 URI file:// 開頭的 URI，該 Create 方法將回傳一個 FileWebRequest 實例。

已登記的預登記儲備類型包括以下類型：

• http://

• https://

• ftp://

• file://

.NET 支援 http://、 https://、 ftp://file:// 及 URI 等方案。 用來處理其他請求的自訂 WebRequest 後代會註冊在該 RegisterPrefix 方法中。

該 Create 方法使用參數 requestUriString 建立 Uri 一個實例，並傳給新的 WebRequest。

Note

當您在應用程式中啟用網路追蹤時，此成員會輸出追蹤資訊。 欲了解更多資訊，請參閱.NET框架中的網絡追蹤。

另請參閱

• 程式設計可插拔協定

Create(Uri)

來源:

WebRequest.cs

警告

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

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

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);

[<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 A 包含所請求資源的 URI。

傳回

WebRequest

指定 URI 方案的 WebRequest 後代。

屬性

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 方法。

例如，當一個以 http:// 或 https:// 開頭的 URI 傳遞至 requestUri時，會 HttpWebRequest 被 Create返回 。 如果傳遞以 URI ftp:// 開頭的 URI，該 Create 方法將回傳一個 FileWebRequest 實例。 如果傳遞以 URI file:// 開頭的 URI，該 Create 方法將回傳一個 FileWebRequest 實例。

已登記的預登記儲備類型包括以下類型：

• http://

• https://

• ftp://

• file://

.NET 支援 http://、 https://、 ftp://file:// 及 URI 等方案。 用來處理其他請求的自訂 WebRequest 後代會註冊在該 RegisterPrefix 方法中。

Note

當您在應用程式中啟用網路追蹤時，此成員會輸出追蹤資訊。 欲了解更多資訊，請參閱.NET框架中的網絡追蹤。