WebRequest.CreateHttp 方法

定義

命名空間:

System.Net

組件:

System.Net.Requests.dll

為指定的 URI 配置，初始化新的 HttpWebRequest 執行個體。

多載

CreateHttp(String)	已淘汰. 為指定的 URI 字串，初始化新的 HttpWebRequest 執行個體。
CreateHttp(Uri)	已淘汰. 為指定的 URI 配置，初始化新的 HttpWebRequest 執行個體。

CreateHttp(String)

警告

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

為指定的 URI 字串，初始化新的 HttpWebRequest 執行個體。

public:
 static System::Net::HttpWebRequest ^ CreateHttp(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.HttpWebRequest CreateHttp (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 CreateHttp : string -> System.Net.HttpWebRequest

Public Shared Function CreateHttp (requestUriString As String) As HttpWebRequest

參數

requestUriString

String

識別網際網路資源的 URI 字串。

傳回

HttpWebRequest

特定 URI 字串的 HttpWebRequest 執行個體。

屬性

ObsoleteAttribute

例外狀況

NotSupportedException

requestUriString 中指定的要求配置為 http 或 https 配置。

ArgumentNullException

requestUriString 為 null。

SecurityException

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

UriFormatException

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

備註

方法會 CreateHttp(String) 傳 requestUriString 回 的 HttpWebRequest 類別實例。

當以 或 開頭 http:// 的 URI 在 參數中 requestUriString 傳遞時， HttpWebRequest 會由 傳 CreateHttp(String)https:// 回 。 任何其他配置都會擲回 NotSupportedException 。

方法 CreateHttp(String) 會 requestUriString 使用 參數來建立 Uri 傳遞給新 HttpWebRequest 的實例。 如果方法成功， AllowReadStreamBuffering 傳 HttpWebRequest 回實例上的 屬性會設定為 false 。

.NET 包含 和 https:// URI 配置的支援 http:// 。 處理其他要求的自訂 WebRequest 子系會向 RegisterPrefix 方法註冊。 方法 Create(String) 可用來為其他配置建立 類別的 WebRequest 子系。

CreateHttp(Uri)

警告

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

為指定的 URI 配置，初始化新的 HttpWebRequest 執行個體。

public:
 static System::Net::HttpWebRequest ^ CreateHttp(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.HttpWebRequest CreateHttp (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 CreateHttp : Uri -> System.Net.HttpWebRequest

Public Shared Function CreateHttp (requestUri As Uri) As HttpWebRequest

參數

requestUri

Uri

識別網際網路資源的 URI。

傳回

HttpWebRequest

特定 URI 字串的 HttpWebRequest 執行個體。

屬性

ObsoleteAttribute

例外狀況

NotSupportedException

requestUri 中指定的要求配置為 http 或 https 配置。

ArgumentNullException

requestUri 為 null。

SecurityException

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

UriFormatException

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

備註

方法會 CreateHttp(Uri) 傳 requestUri 回 的 HttpWebRequest 類別實例。

當以 或 http:// 開頭 http:// 的 URI 在 參數中 requestUri 傳遞時， HttpWebRequest 會傳回 。 CreateHttp(Uri) 另一個其他配置會擲回 NotSupportedException 。

方法 CreateHttp(Uri) 會 requestUri 使用 參數來建立新的 HttpWebRequest 實例。 如果方法成功， AllowReadStreamBuffering 傳 HttpWebRequest 回實例上的 屬性會設定為 false 。

.NET 包含 和 https:// URI 配置的支援 http:// 。 處理其他要求的自訂 WebRequest 子系會向 RegisterPrefix 方法註冊。 方法 Create(Uri) 可用來為其他配置建立 類別的 WebRequest 子系。