HttpClientHandler Classe

Définition

Espace de noms:

System.Net.Http

Assemblys:

netstandard.dll, System.Net.Http.dll

Source:

HttpClientHandler.cs

Gestionnaire de messages par défaut utilisé dans HttpClient .NET Framework.

public ref class HttpClientHandler : System::Net::Http::HttpMessageHandler

public class HttpClientHandler : System.Net.Http.HttpMessageHandler

type HttpClientHandler = class
    inherit HttpMessageHandler

Public Class HttpClientHandler
Inherits HttpMessageHandler

Héritage

Object

HttpMessageHandler

HttpClientHandler

Dérivé

System.Net.Http.WebRequestHandler

Exemples

static async Task Main()
{
   // Create an HttpClientHandler object and set to use default credentials
   HttpClientHandler handler = new HttpClientHandler();
   handler.UseDefaultCredentials = true;

   // Create an HttpClient object
   HttpClient client = new HttpClient(handler);

   // Call asynchronous network methods in a try/catch block to handle exceptions
   try
   {
      HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");

      response.EnsureSuccessStatusCode();

      string responseBody = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseBody);
   }
   catch(HttpRequestException e)
   {
       Console.WriteLine("\nException Caught!");
       Console.WriteLine("Message :{0} ",e.Message);
   }

   // Need to call dispose on the HttpClient and HttpClientHandler objects
   // when done using them, so the app doesn't leak resources
   handler.Dispose();
   client.Dispose();
}

Remarques

Pour plus d’informations sur cette API, consultez les remarques d’API supplémentaires pour HttpClientHandler.

Constructeurs

Nom	Description
HttpClientHandler()	Crée une instance d’une HttpClientHandler classe.

Propriétés

Nom	Description
AllowAutoRedirect	Obtient ou définit une valeur qui indique si le gestionnaire doit suivre les réponses de redirection.
AutomaticDecompression	Obtient ou définit le type de méthode de décompression utilisée par le gestionnaire pour la décompression automatique de la réponse de contenu HTTP.
CheckCertificateRevocationList	Obtient ou définit une valeur qui indique si le certificat est vérifié par rapport à la liste de révocation de l’autorité de certification.
ClientCertificateOptions	Obtient ou définit une valeur qui indique si le certificat est automatiquement sélectionné dans le magasin de certificats ou si l’appelant est autorisé à passer un certificat client spécifique.
ClientCertificates	Obtient la collection de certificats de sécurité associés aux demandes adressées au serveur.
CookieContainer	Obtient ou définit le conteneur de cookies utilisé pour stocker les cookies du serveur par le gestionnaire.
Credentials	Obtient ou définit les informations d’authentification utilisées par ce gestionnaire.
DangerousAcceptAnyServerCertificateValidator	Obtient un délégué mis en cache qui retourne truetoujours .
DefaultProxyCredentials	Lorsque le proxy par défaut (système) est utilisé, obtient ou définit les informations d’identification à envoyer au serveur proxy par défaut pour l’authentification. Le proxy par défaut est utilisé uniquement lorsqu’il UseProxy est défini true sur et Proxy est défini sur null.
MaxAutomaticRedirections	Obtient ou définit le nombre maximal de redirections que le gestionnaire suit.
MaxConnectionsPerServer	Obtient ou définit le nombre maximal de connexions simultanées (par point de terminaison de serveur) autorisées lors de l’exécution de requêtes à l’aide d’un HttpClient objet. Notez que la limite est par point de terminaison de serveur. Par exemple, une valeur de 256 autorise 256 connexions simultanées à http://www.adatum.com/ et 256 autres à http://www.adventure-works.com/.
MaxRequestContentBufferSize	Obtient ou définit la taille maximale de la mémoire tampon de contenu de requête utilisée par le gestionnaire.
MaxResponseHeadersLength	Obtient ou définit la longueur maximale, en kilo-octets (1024 octets), des en-têtes de réponse. Par exemple, si la valeur est 64, 65536 octets sont autorisés pour la longueur maximale des en-têtes de réponse.
MeterFactory	Obtient ou définit la IMeterFactory valeur à créer une instance personnalisée MeterHttpClientHandler .
PreAuthenticate	Obtient ou définit une valeur qui indique si le gestionnaire envoie un en-tête d’autorisation avec la requête.
Properties	Obtient un dictionnaire accessible en écriture (autrement dit, une carte) de propriétés personnalisées pour les HttpClient requêtes. Le dictionnaire est initialisé vide ; vous pouvez insérer et interroger des paires clé-valeur pour vos gestionnaires personnalisés et traitement spécial.
Proxy	Obtient ou définit les informations de proxy utilisées par le gestionnaire.
ServerCertificateCustomValidationCallback	Obtient ou définit une méthode de rappel pour valider le certificat de serveur.
SslProtocols	Obtient ou définit les protocoles TLS/SSL utilisés par les HttpClient objets gérés par l’objet HttpClientHandler.
SupportsAutomaticDecompression	Obtient une valeur qui indique si le gestionnaire prend en charge la décompression de contenu de réponse automatique.
SupportsProxy	Obtient une valeur qui indique si le gestionnaire prend en charge les paramètres de proxy.
SupportsRedirectConfiguration	Obtient une valeur qui indique si le gestionnaire prend en charge les paramètres de configuration pour les propriétés et MaxAutomaticRedirections les AllowAutoRedirect propriétés.
UseCookies	Obtient ou définit une valeur qui indique si le gestionnaire utilise la CookieContainer propriété pour stocker les cookies du serveur et utilise ces cookies lors de l’envoi de requêtes.
UseDefaultCredentials	Obtient ou définit une valeur qui contrôle si les informations d’identification par défaut sont envoyées avec des requêtes par le gestionnaire.
UseProxy	Obtient ou définit une valeur qui indique si le gestionnaire utilise un proxy pour les requêtes.

Méthodes

Nom	Description
Dispose()	Libère les ressources non managées et supprime les ressources managées utilisées par le HttpMessageHandler. (Hérité de HttpMessageHandler)
Dispose(Boolean)	Libère les ressources non managées utilisées par les HttpClientHandler ressources gérées et supprime éventuellement les ressources gérées.
Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
Send(HttpRequestMessage, CancellationToken)	Crée une instance basée HttpResponseMessage sur les informations fournies dans le HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Crée une instance basée HttpResponseMessage sur les informations fournies dans le HttpRequestMessage cadre d’une opération qui ne bloque pas.
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• Connexion à un service web
• Démarrage rapide : Connexion à l’aide de HttpClient
• Comment utiliser des gestionnaires HttpClient
• Comment sécuriser les connexions HttpClient