WebRequest.CreateHttp Methode

Definition

Initialisiert eine neue HttpWebRequest-Instanz für den angegebenen URI.Initializes a new HttpWebRequest instance for the specified URI.

Überlädt

CreateHttp(String)

Initialisiert eine neue HttpWebRequest-Instanz für die angegebene URI-Zeichenfolge.Initializes a new HttpWebRequest instance for the specified URI string.

CreateHttp(Uri)

Initialisiert eine neue HttpWebRequest-Instanz für den angegebenen URI.Initializes a new HttpWebRequest instance for the specified URI.

CreateHttp(String)

Initialisiert eine neue HttpWebRequest-Instanz für die angegebene URI-Zeichenfolge.Initializes a new HttpWebRequest instance for the specified URI string.

public:
 static System::Net::HttpWebRequest ^ CreateHttp(System::String ^ requestUriString);
public static System.Net.HttpWebRequest CreateHttp (string requestUriString);
static member CreateHttp : string -> System.Net.HttpWebRequest
Public Shared Function CreateHttp (requestUriString As String) As HttpWebRequest

Parameter

requestUriString
String

Eine URI-Zeichenfolge, mit der die Internetressource bezeichnet wird.A URI string that identifies the Internet resource.

Gibt zurück

Eine HttpWebRequest-Instanz für die spezifische URI-Zeichenfolge.An HttpWebRequest instance for the specific URI string.

Ausnahmen

Das in requestUriString angegebene Anforderungsschema ist das http- oder das https-Schema.The request scheme specified in requestUriString is the http or https scheme.

requestUriString ist null.requestUriString is null.

Der Aufrufer besitzt keine WebPermissionAttribute-Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wurde.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Der in requestUriString angegebene URI ist kein gültiger URI.The URI specified in requestUriString is not a valid URI.

Hinweise

Die CreateHttp(String) -Methode gibt eine Instanz HttpWebRequest der-Klasse für requestUriStringdas zurück.The CreateHttp(String) method returns an instance of the HttpWebRequest class for the requestUriString.

Wenn ein URI, der http:// requestUriString mit oder https:// beginnt, im-Parameter übergeben wird HttpWebRequest , wird von CreateHttp(String)eine zurückgegeben.When a URI that begins with http:// or https:// is passed in the requestUriString parameter, a HttpWebRequest is returned by CreateHttp(String). Jedes andere Schema löst eine NotSupportedExceptionaus.Any other scheme will throw a NotSupportedException.

Die CreateHttp(String) -Methode verwendet requestUriString den-Parameter, Uri um eine-Instanz zu erstellen, HttpWebRequestdie Sie an die neue übergibt.The CreateHttp(String) method uses the requestUriString parameter to create a Uri instance that it passes to the new HttpWebRequest. Wenn die Methode erfolgreich ist, wird AllowReadStreamBuffering die-Eigenschaft der HttpWebRequest zurückgegebenen-Instanz falseauf festgelegt.If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.

.Net bietet Unterstützung für http:// die https:// -und-URI-Schemas..NET includes support for the http:// and https:// URI schemes. Benutzer WebRequest definierte Nachfolger, die andere Anforderungen verarbeiten, werden RegisterPrefix bei der-Methode registriert.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method. Die Create(String) -Methode kann verwendet werden, um einen Nachfolger WebRequest der-Klasse für andere Schemas zu erstellen.The Create(String) method can be used to create a descendant of the WebRequest class for other schemes.

CreateHttp(Uri)

Initialisiert eine neue HttpWebRequest-Instanz für den angegebenen URI.Initializes a new HttpWebRequest instance for the specified URI.

public:
 static System::Net::HttpWebRequest ^ CreateHttp(Uri ^ requestUri);
public static System.Net.HttpWebRequest CreateHttp (Uri requestUri);
static member CreateHttp : Uri -> System.Net.HttpWebRequest
Public Shared Function CreateHttp (requestUri As Uri) As HttpWebRequest

Parameter

requestUri
Uri

Ein URI, mit dem die Internetressource bezeichnet wird.A URI that identifies the Internet resource.

Gibt zurück

Eine HttpWebRequest-Instanz für die spezifische URI-Zeichenfolge.An HttpWebRequest instance for the specific URI string.

Ausnahmen

Das in requestUri angegebene Anforderungsschema ist das http- oder das https-Schema.The request scheme specified in requestUri is the http or https scheme.

requestUri ist null.requestUri is null.

Der Aufrufer besitzt keine WebPermissionAttribute-Berechtigung zum Herstellen einer Verbindung mit dem angeforderten URI oder einem URI, an den die Anforderung umgeleitet wurde.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

Der in requestUri angegebene URI ist kein gültiger URI.The URI specified in requestUri is not a valid URI.

Hinweise

Die CreateHttp(Uri) -Methode gibt eine Instanz HttpWebRequest der-Klasse für requestUridas zurück.The CreateHttp(Uri) method returns an instance of the HttpWebRequest class for the requestUri.

Wenn ein URI, der http:// requestUri mit oder http:// beginnt, im-Parameter übergeben wird HttpWebRequest , wird von CreateHttp(Uri)eine zurückgegeben.When a URI that begins with http:// or http:// is passed in the requestUri parameter, an HttpWebRequest is returned by CreateHttp(Uri). Ein anderes Schema löst einen NotSupportedExceptionaus.Another other scheme will throw a NotSupportedException.

Die CreateHttp(Uri) -Methode verwendet requestUri den-Parameter, um HttpWebRequest eine neue-Instanz zu erstellen.The CreateHttp(Uri) method uses the requestUri parameter to create a new HttpWebRequest instance. Wenn die Methode erfolgreich ist, wird AllowReadStreamBuffering die-Eigenschaft der HttpWebRequest zurückgegebenen-Instanz falseauf festgelegt.If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.

.Net bietet Unterstützung für http:// die https:// -und-URI-Schemas..NET includes support for the http:// and https:// URI schemes. Benutzer WebRequest definierte Nachfolger, die andere Anforderungen verarbeiten, werden RegisterPrefix bei der-Methode registriert.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method. Die Create(Uri) -Methode kann verwendet werden, um einen Nachfolger WebRequest der-Klasse für andere Schemas zu erstellen.The Create(Uri) method can be used to create a descendant of the WebRequest class for other schemes.

Gilt für: