共用方式為


WebRequest.Create 方法

定義

初始化新的 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。

傳回

特定 URI 配置的 WebRequest 子代。

屬性

例外狀況

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

requestUriStringnull

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

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

方法 CreaterequestUriString 使用 參數來建立 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 子代,屬於指定的 URI 配置。

屬性

例外狀況

requestUri 中指定的要求配置未登錄。

requestUrinull

呼叫端沒有 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 中的網路追蹤

適用於