WebRequest.CreateDefault(Uri) 方法

定義

命名空間:

System.Net

組件:

System.Net.Requests.dll

來源:

WebRequest.cs

警告

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

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

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

Public Shared Function CreateDefault (requestUri As Uri) As WebRequest

參數

requestUri

Uri

Uri，包含要求資源的 URI。

傳回

WebRequest

WebRequest 子代，屬於指定的 URI 配置。

屬性

ObsoleteAttribute

例外狀況

NotSupportedException

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

ArgumentNullException

requestUri 為 null。

SecurityException

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

備註

方法 CreateDefault 只會根據 URI 的配置部分傳回 WebRequest 子系實例。

例如，當開頭為 http:// 的 URI 傳入 requestUri時， HttpWebRequest 會由 傳 CreateDefault回 。 如果改為傳遞開頭為 的 file:// URI， CreateDefault 方法會傳回 FileWebRequest。

注意

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