WebRequest::Create Method (Uri^)
Initializes a new WebRequest instance for the specified URI scheme.
Assembly: System (in System.dll)
Parameters
- requestUri
-
Type:
System::Uri^
A Uri containing the URI of the requested resource.
| Exception | Condition |
|---|---|
| NotSupportedException | The request scheme specified in requestUri is not registered. |
| ArgumentNullException | requestUri is null. |
| SecurityException | The caller does not have permission to connect to the requested URI or a URI that the request is redirected to. |
The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.
For example, if you create a WebRequest descendant, Handler1, to handle requests to http://www.contoso.com/text/ and another named Handler2 to handle requests to http://www.contoso.com/code/, you can use Create method to return the WebRequest descendant associated with either specified URI.
To return a descendant of the WebRequest class based on only the scheme portion of a URI, use the CreateDefault method.
For example, when a URI beginning with http:// or https:// is passed in requestUri, an HttpWebRequest is returned by Create. If a URI beginning with ftp:// is passed instead, the Create method will return a FileWebRequest instance. If a URI beginning with file:// is passed instead, the Create method will return a FileWebRequest instance.
The pre-registered reserve types already registered include the following:
http://
https://
ftp://
file://
The .NET Framework includes support for the http://, https://, ftp://, and file:// URI schemes. Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.
Note |
|---|
This member outputs trace information when you enable network tracing in your application. For more information, see Network Tracing in the .NET Framework. |
The following example uses Create to instantiate an HttpWebRequest instance. A Uri representing the target URL is used as the constructor parameter.
// Create a new 'Uri' object with the specified string. Uri^ myUri = gcnew Uri( "http://www.contoso.com" ); // Create a new request to the above mentioned URL. WebRequest^ myWebRequest = WebRequest::Create( myUri ); // Assign the response object of 'WebRequest' to a 'WebResponse' variable. WebResponse^ myWebResponse = myWebRequest->GetResponse();
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
