WebRequest.Create Method (String)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Initializes a new WebRequest instance for the specified URI scheme.
Assembly: System.Net (in System.Net.dll)
Parameters
- requestUriString
- Type: System.String
The URI string 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(String) 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:// is passed in requestUri, an HttpWebRequest is returned by Create.
The .NET Framework includes support for the http:// and https:// URI schemes. Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method.
The Create(String) method uses the requestUriString parameter to create a Uri instance that it passes to the new WebRequest.
Version Notes
Windows Phone
If you attempt to access a file from an FTP site, the application throws NullRefrenceException instead of NotSupportedException.