WebRequest.CreateDefault(Uri) Method

Definition

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

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