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.cs

來源:: WebRequest.cs

來源:: 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

識別網際網路資源的 URI。

傳回

WebRequest

特定 URI 配置的 WebRequest 子代。

屬性: ObsoleteAttribute

例外狀況

NotSupportedException

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

ArgumentNullException

requestUriString 為 null。

SecurityException

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

UriFormatException

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

注意：在適用於 Windows 市集應用程式的 .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.cs

來源:: WebRequest.cs

來源:: 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 = 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)

參數

傳回

例外狀況

範例

備註

適用於

其他資源