WebRequest.CreateHttp Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Initialise une nouvelle instance de HttpWebRequest pour l'URI spécifié.
Surcharges
CreateHttp(String) |
Obsolète.
Initialise une nouvelle instance de HttpWebRequest pour la chaîne d'URI spécifiée. |
CreateHttp(Uri) |
Obsolète.
Initialise une nouvelle instance de HttpWebRequest pour l'URI spécifié. |
CreateHttp(String)
- Source:
- WebRequest.cs
- Source:
- WebRequest.cs
- Source:
- WebRequest.cs
Attention
WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.
Initialise une nouvelle instance de HttpWebRequest pour la chaîne d'URI spécifiée.
public:
static System::Net::HttpWebRequest ^ CreateHttp(System::String ^ requestUriString);
public static System.Net.HttpWebRequest CreateHttp (string requestUriString);
[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.HttpWebRequest CreateHttp (string requestUriString);
static member CreateHttp : string -> System.Net.HttpWebRequest
[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
static member CreateHttp : string -> System.Net.HttpWebRequest
Public Shared Function CreateHttp (requestUriString As String) As HttpWebRequest
Paramètres
- requestUriString
- String
Chaîne d'URI qui identifie la ressource Internet.
Retours
Instance de HttpWebRequest pour la chaîne d’URI spécifique.
- Attributs
Exceptions
Le schéma de demande spécifié dans requestUriString
est le schéma http ou https.
requestUriString
a la valeur 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.
L’URI spécifié dans requestUriString
n’est pas un URI valide.
Remarques
La CreateHttp(String) méthode retourne une instance de la HttpWebRequest classe pour .requestUriString
Lorsqu’un URI commençant par http://
ou est passé dans le requestUriString
paramètre, un HttpWebRequest est retourné par CreateHttp(String)https://
. Tout autre schéma lève un NotSupportedException.
La CreateHttp(String) méthode utilise le requestUriString
paramètre pour créer une Uri instance qu’elle transmet au nouveau HttpWebRequest. Si la méthode réussit, la AllowReadStreamBuffering propriété sur l’instance retournée HttpWebRequest est définie sur false
.
.NET inclut la prise en charge des schémas d’URI http://
et https://
. Les descendants personnalisés WebRequest pour gérer d’autres demandes sont inscrits auprès de la RegisterPrefix méthode . La Create(String) méthode peut être utilisée pour créer un descendant de la WebRequest classe pour d’autres schémas.
S’applique à
CreateHttp(Uri)
- Source:
- WebRequest.cs
- Source:
- WebRequest.cs
- Source:
- WebRequest.cs
Attention
WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.
Initialise une nouvelle instance de HttpWebRequest pour l'URI spécifié.
public:
static System::Net::HttpWebRequest ^ CreateHttp(Uri ^ requestUri);
public static System.Net.HttpWebRequest CreateHttp (Uri requestUri);
[System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
public static System.Net.HttpWebRequest CreateHttp (Uri requestUri);
static member CreateHttp : Uri -> System.Net.HttpWebRequest
[<System.Obsolete("WebRequest, HttpWebRequest, ServicePoint, and WebClient are obsolete. Use HttpClient instead.", DiagnosticId="SYSLIB0014", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
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.
Retours
Instance de HttpWebRequest pour la chaîne d’URI spécifique.
- Attributs
Exceptions
Le schéma de demande spécifié dans requestUri
est le schéma http ou https.
requestUri
a la valeur 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.
L’URI spécifié dans requestUri
n’est pas un URI valide.
Remarques
La CreateHttp(Uri) méthode retourne une instance de la HttpWebRequest classe pour .requestUri
Lorsqu’un URI commençant par http://
ou est passé dans le requestUri
paramètre, un HttpWebRequest est retourné par CreateHttp(Uri)http://
. Un autre schéma lève un NotSupportedException.
La CreateHttp(Uri) méthode utilise le requestUri
paramètre pour créer une HttpWebRequest instance. Si la méthode réussit, la AllowReadStreamBuffering propriété sur l’instance retournée HttpWebRequest est définie sur false
.
.NET inclut la prise en charge des schémas d’URI http://
et https://
. Les descendants personnalisés WebRequest pour gérer d’autres demandes sont inscrits auprès de la RegisterPrefix méthode . La Create(Uri) méthode peut être utilisée pour créer un descendant de la WebRequest classe pour d’autres schémas.