WebRequest.CreateHttp 方法

  • 參考

定義

命名空間:
System.Net
組件:
System.Net.Requests.dll
組件:
System.dll
組件:
netstandard.dll

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

多載

CreateHttp(String)
已淘汰.

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

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

CreateHttp(String)

來源:
WebRequest.cs
來源:
WebRequest.cs
來源:
WebRequest.cs

警告

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

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

public:
 static System::Net::HttpWebRequest ^ CreateHttp(System::String ^ requestUriString);
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}")]
public static System.Net.HttpWebRequest CreateHttp (string requestUriString);
static member CreateHttp : string -> System.Net.HttpWebRequest
[<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.cs
來源:
WebRequest.cs
來源:
WebRequest.cs

警告

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

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

public:
 static System::Net::HttpWebRequest ^ CreateHttp(Uri ^ requestUri);
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);
static member CreateHttp : Uri -> System.Net.HttpWebRequest
[<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://的 URI 傳入 參數時requestUri，HttpWebRequest會傳回 。CreateHttp(Uri)http:// 另一個其他設定會擲回 NotSupportedException。

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

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

適用於