WebRequest::Create Method (String^)
Initializes a new WebRequest instance for the specified URI scheme.
Assembly: System (in System.dll)
Parameters
- requestUriString
-
Type:
System::String^
The URI that identifies the Internet resource.
| Exception | Condition | ||
|---|---|---|---|
| NotSupportedException | The request scheme specified in requestUriString has not been registered. | ||
| ArgumentNullException | requestUriString is null. | ||
| SecurityException | The caller does not have permission to connect to the requested URI or a URI that the request is redirected to. | ||
| UriFormatException |
The URI specified in requestUriString is not a valid URI. |
The Create method returns a descendant of the WebRequest class determined at run time as the closest registered match for requestUri.
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.
The Create method uses the requestUriString parameter to create a Uri instance that it passes to the new WebRequest.
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 string representing the target URL is used as the constructor parameter.
Uri^ ourUri = gcnew Uri( url ); // Create a 'WebRequest' object with the specified url. WebRequest^ myWebRequest = WebRequest::Create( url ); // Send the 'WebRequest' and wait for response. WebResponse^ myWebResponse = myWebRequest->GetResponse(); // Use "ResponseUri" property to get the actual Uri from where the response was attained. if ( ourUri->Equals( myWebResponse->ResponseUri ) ) { Console::WriteLine( "\nRequest Url : {0} was not redirected", url ); } else { Console::WriteLine( "\nRequest Url : {0} was redirected to {1}", url, myWebResponse->ResponseUri ); } // Release resources of response object. myWebResponse->Close();
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 3.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
