WebRequest.CreateHttp Méthode

Définition

Initialise une nouvelle instance de HttpWebRequest pour l'URI spécifié.Initializes a new HttpWebRequest instance for the specified URI.

Surcharges

CreateHttp(String)

Initialise une nouvelle instance de HttpWebRequest pour la chaîne URI spécifiée.Initializes a new HttpWebRequest instance for the specified URI string.

CreateHttp(Uri)

Initialise une nouvelle instance de HttpWebRequest pour l'URI spécifié.Initializes a new HttpWebRequest instance for the specified URI.

CreateHttp(String)

Initialise une nouvelle instance de HttpWebRequest pour la chaîne URI spécifiée.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

Paramètres

requestUriString
String

Chaîne URI qui identifie la ressource Internet.A URI string that identifies the Internet resource.

Retours

Instance de HttpWebRequest pour la chaîne d’URI spécifique.An HttpWebRequest instance for the specific URI string.

Exceptions

Le schéma de demande spécifié dans requestUriString est le schéma http ou https.The request scheme specified in requestUriString is the http or https scheme.

requestUriString a la valeur null.requestUriString is null.

L’appelant n’a pas l’autorisation WebPermissionAttribute de se connecter à l’URI demandé ou à un URI vers lequel la demande est redirigée.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

L’URI spécifié dans requestUriString n’est pas un URI valide.The URI specified in requestUriString is not a valid URI.

Remarques

La CreateHttp(String) méthode retourne une instance de la HttpWebRequest classe pour requestUriString.The CreateHttp(String) method returns an instance of the HttpWebRequest class for the requestUriString.

Lorsqu’un URI qui commence par http:// ou https:// est passé dans le requestUriString paramètre, une HttpWebRequest est retournée CreateHttp(String)par.When a URI that begins with http:// or https:// is passed in the requestUriString parameter, a HttpWebRequest is returned by CreateHttp(String). Tout autre schéma lève une NotSupportedExceptionexception.Any other scheme will throw a NotSupportedException.

La CreateHttp(String) méthode utilise le requestUriString paramètre pour créer une Uri instance qu’il transmet au nouveau HttpWebRequest.The CreateHttp(String) method uses the requestUriString parameter to create a Uri instance that it passes to the new HttpWebRequest. Si la méthode réussit, la AllowReadStreamBuffering propriété sur l’instance HttpWebRequest retournée a la falsevaleur.If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.

.NET prend en charge les http:// schémas https:// d’URI et..NET includes support for the http:// and https:// URI schemes. Les WebRequest descendants personnalisés pour gérer d’autres demandes sont inscrits RegisterPrefix avec la méthode.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method. La Create(String) méthode peut être utilisée pour créer un descendant de la WebRequest classe pour d’autres schémas.The Create(String) method can be used to create a descendant of the WebRequest class for other schemes.

CreateHttp(Uri)

Initialise une nouvelle instance de HttpWebRequest pour l'URI spécifié.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

Paramètres

requestUri
Uri

URI qui identifie la ressource Internet.A URI that identifies the Internet resource.

Retours

Instance de HttpWebRequest pour la chaîne d’URI spécifique.An HttpWebRequest instance for the specific URI string.

Exceptions

Le schéma de demande spécifié dans requestUri est le schéma http ou https.The request scheme specified in requestUri is the http or https scheme.

requestUri a la valeur null.requestUri is null.

L’appelant n’a pas l’autorisation WebPermissionAttribute de se connecter à l’URI demandé ou à un URI vers lequel la demande est redirigée.The caller does not have WebPermissionAttribute permission to connect to the requested URI or a URI that the request is redirected to.

L’URI spécifié dans requestUri n’est pas un URI valide.The URI specified in requestUri is not a valid URI.

Remarques

La CreateHttp(Uri) méthode retourne une instance de la HttpWebRequest classe pour requestUri.The CreateHttp(Uri) method returns an instance of the HttpWebRequest class for the requestUri.

Lorsqu’un URI qui commence par http:// ou http:// est passé dans le requestUri paramètre, une HttpWebRequest est retournée CreateHttp(Uri)par.When a URI that begins with http:// or http:// is passed in the requestUri parameter, an HttpWebRequest is returned by CreateHttp(Uri). Un autre schéma lève une NotSupportedExceptionexception.Another other scheme will throw a NotSupportedException.

La CreateHttp(Uri) méthode utilise le requestUri paramètre pour créer une nouvelle HttpWebRequest instance.The CreateHttp(Uri) method uses the requestUri parameter to create a new HttpWebRequest instance. Si la méthode réussit, la AllowReadStreamBuffering propriété sur l’instance HttpWebRequest retournée a la falsevaleur.If the method is successful, the AllowReadStreamBuffering property on the returned HttpWebRequest instance is set to false.

.NET prend en charge les http:// schémas https:// d’URI et..NET includes support for the http:// and https:// URI schemes. Les WebRequest descendants personnalisés pour gérer d’autres demandes sont inscrits RegisterPrefix avec la méthode.Custom WebRequest descendants to handle other requests are registered with the RegisterPrefix method. La Create(Uri) méthode peut être utilisée pour créer un descendant de la WebRequest classe pour d’autres schémas.The Create(Uri) method can be used to create a descendant of the WebRequest class for other schemes.

S’applique à