WebRequest.CreateHttp Method (Uri)
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Initializes a new HttpWebRequest instance for the specified URI.
Assembly: System.Net (in System.Net.dll)
Parameters
- requestUri
- Type: System.Uri
A URI that identifies the Internet resource.
| Exception | Condition |
|---|---|
| NotSupportedException | The request scheme specified in requestUri is the http or https scheme. |
| 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. |
| UriFormatException | The URI specified in requestUri is not a valid URI. |
The CreateHttp(Uri) method returns an instance of the HttpWebRequest class for the requestUri.
When a URI that begins with http:// or http:// is passed in the requestUri parameter, an HttpWebRequest is returned by CreateHttp(Uri). Another other scheme will throw a NotSupportedException.
The CreateHttp(Uri) method uses the requestUri parameter to create a new HttpWebRequest instance. If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.
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(Uri) method can be used to create a descendant of the WebRequest class for other schemes.