HttpClientHandler Classe

Définition

Espace de noms:

System.Net.Http

Assembly:

System.Net.Http.dll

Source:

HttpClientHandler.cs

Gestionnaire de messages par défaut utilisé par HttpClient dans le .NET Framework et .NET Core 2.0 et antérieur.

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 Remarques supplémentaires sur l’API pour HttpClientHandler.

Constructeurs

HttpClientHandler()

Crée une instance d’une classe HttpClientHandler.

Propriétés

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é par le gestionnaire pour la décompression automatique de la réponse du 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 prélevé dans le magasin de certificats ou si l’appelant est autorisé à transmettre 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 du cookie utilisé pour stocker des cookies de 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 toujours true.
DefaultProxyCredentials	Quand 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 quand UseProxy a la valeur true et Proxy a la valeur null.
MaxAutomaticRedirections	Récupère ou définit le nombre maximal de redirections suivies par le gestionnaire.
MaxConnectionsPerServer	Obtient ou définit le nombre maximal de connexions simultanées (par point de terminaison de serveur) autorisé lors de l’établissement de demandes à l’aide d’un objet HttpClient. Notez que la limite est établie par point de terminaison de serveur : par exemple, une valeur de 256 permettrait 256 connexions simultanées à http://www.adatum.com/ et 256 autres à http://www.adventure-works.com/.
MaxRequestContentBufferSize	Obtient ou définit la taille de mémoire tampon du contenu de requête maximale 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, 65 536 octets sont autorisés pour la longueur maximale des en-têtes de réponse.
MeterFactory	Obtient ou définit le IMeterFactory pour créer un personnalisé Meter pour le HttpClientHandler instance.
PreAuthenticate	Obtient ou définit une valeur indiquant si le gestionnaire envoie un en-tête d’autorisation avec la requête.
Properties	Obtient un dictionnaire accessible en écriture (autrement dit, un mappage) des propriétés personnalisées pour les demandes HttpClient. Le dictionnaire est initialisé vide ; vous pouvez insérer et interroger des paires clé-valeur pour vos gestionnaires personnalisés et un traitement spécial.
Proxy	Obtient ou définit les informations du 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 le protocole TLS/SSL utilisé par les objets HttpClient gérés par l’objet HttpClientHandler.
SupportsAutomaticDecompression	Obtient une valeur qui indique si le gestionnaire prend en charge la décompression automatique du contenu de la réponse.
SupportsProxy	Obtient une valeur qui indique si le gestionnaire prend en charge les paramètres du proxy.
SupportsRedirectConfiguration	Obtient une valeur qui indique si le gestionnaire prend en charge les paramètres de configuration des propriétés AllowAutoRedirect et MaxAutomaticRedirections.
UseCookies	Obtient ou définit une valeur qui indique si le gestionnaire utilise la propriété pour stocker les CookieContainer 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 les 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

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 le HttpClientHandler et supprime éventuellement les ressources managées.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
Send(HttpRequestMessage, CancellationToken)	Crée une instance de en fonction des HttpResponseMessage informations fournies dans .HttpRequestMessage
SendAsync(HttpRequestMessage, CancellationToken)	Crée une instance de en fonction des HttpResponseMessage informations fournies dans le HttpRequestMessage en tant qu’opération qui ne sera pas bloquée.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Se connecter à un service web
• Démarrage rapide : Connexion à l’aide de HttpClient
• Guide pratique pour utiliser les gestionnaires HttpClient
• Guide pratique pour sécuriser les connexions HttpClient
• Exemple HttpClient