WebRequest.Create 方法

參考

定義

命名空間:: System.Net

組件:: System.Net.Requests.dll

組件:: System.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 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

識別網際網路資源的 URI。

傳回

WebRequest

特定 URI 配置的 WebRequest 子代。

屬性: ObsoleteAttribute

例外狀況

NotSupportedException

在 requestUriString 中指定的要求配置尚未註冊。

ArgumentNullException

requestUriString 為 null。

SecurityException

呼叫端沒有 WebPermissionAttribute 權限以連線至要求的 URI，或連線至要求重新導向目標的 URI。

UriFormatException

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 。

例如，當開頭為 http:// 或 https:// 的 URI 傳入 requestUri 時， HttpWebRequest 會傳回。 Create 如果改為傳遞開頭為的 ftp:// URI，方法 Create 會傳 FtpWebRequest 回實例。如果改為傳遞開頭為的 file:// URI，方法 Create 會傳 FileWebRequest 回實例。

已註冊的預先註冊保留類型包括下列各項：

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

.NET 包含、 https:// 、 ftp:// 和 file:// URI 配置的支援 http:// 。處理其他要求的自訂 WebRequest 子系會向 RegisterPrefix 方法註冊。

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

參數

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 = 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 。

例如，如果您建立子代 Handler1 來處理的要求 http://www.contoso.com/text/ ，以及另一個具名 Handler2 來處理的要求 http://www.contoso.com/code/ ，您可以使用 Create 方法來傳回與任一 WebRequest 指定 URI 相關聯的 WebRequest 子系。

若要根據 URI 的配置部分傳回類別的 WebRequest 子系，請使用 CreateDefault 方法。

例如，當開頭為 http:// 或 https:// 的 URI 傳入 requestUri 時， HttpWebRequest 會傳回。 Create 如果改為傳遞開頭為的 ftp:// URI，方法 Create 會傳 FileWebRequest 回實例。如果改為傳遞開頭為的 file:// URI，方法 Create 會傳 FileWebRequest 回實例。

已註冊的預先註冊保留類型包括下列各項：

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

.NET 包含、 https:// 、 ftp:// 和 file:// URI 配置的支援 http:// 。處理其他要求的自訂 WebRequest 子系會向 RegisterPrefix 方法註冊。

注意

在應用程式中啟用網路追蹤時，這個成員會輸出追蹤資訊。如需詳細資訊，請參閱.NET Framework中的網路追蹤。

適用於

WebRequest.Create 方法

定義

多載

Create(String)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

Create(Uri)

參數

傳回

例外狀況

範例

備註

適用於

其他資源