Edit

Share via


WebRequest.CreateDefault(Uri) Method

Definition

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

A WebRequest descendant for the specified URI scheme.

Attributes

Exceptions

The request scheme specified in requestUri is not registered.

requestUri is null.

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