WebRequest.CreateDefault(Uri) Method

Definition

Namespace:

System.Net

Assembly:

System.Net.Requests.dll

Source:

WebRequest.cs

Caution

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

Initializes a new WebRequest instance for the specified URI scheme.

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

Parameters

requestUri

Uri

A Uri containing the URI of the requested resource.

Returns

WebRequest

A WebRequest descendant for the specified URI scheme.

Attributes

ObsoleteAttribute

Exceptions

NotSupportedException

The request scheme specified in requestUri is not registered.

ArgumentNullException

requestUri is null.

SecurityException

The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Remarks

The CreateDefault method returns a WebRequest descendant instance based on only the scheme portion of a URI.

For example, when a URI beginning with http:// is passed in requestUri, an HttpWebRequest is returned by CreateDefault. If a URI beginning with file:// is passed instead, the CreateDefault method will return a FileWebRequest.

Note

This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing in .NET.