WebRequest::CreateHttp Method (Uri^)
Initializes a new HttpWebRequest instance for the specified URI.
Assembly: System (in System.dll)
Parameters
- requestUri
-
Type:
System::Uri^
A URI that identifies the Internet resource.
Return Value
Type: System.Net::HttpWebRequest^Returns HttpWebRequest.
An HttpWebRequest instance for the specific URI string.
| 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.
Available since 8
.NET Framework
Available since 4.5
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 4.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1