WebRequest.CreateDefault(Uri) Method

Reference

Definition

Namespace:: System.Net

Assembly:: System.Net.Requests.dll

Assembly:: System.dll

Assembly:: netstandard.dll

Source:: WebRequest.cs

Source:: WebRequest.cs

Source:: WebRequest.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

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);

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);

static member CreateDefault : 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 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.

Applies to