WinHttpHandler Classe

Définition

Gère les messages en fonction de l’interface WinHTTP de Windows. Cette classe est destinée à être utilisée dans les environnements serveur.

public ref class WinHttpHandler : System::Net::Http::HttpMessageHandler
public class WinHttpHandler : System.Net.Http.HttpMessageHandler
type WinHttpHandler = class
    inherit HttpMessageHandler
Public Class WinHttpHandler
Inherits HttpMessageHandler
Héritage
WinHttpHandler

Remarques

WinHttpHandler est similaire à d’autres classes existantes telles que HttpClientHandler. WinHttpHandler fournit un gestionnaire sous une HttpClient instance et est utilisé pour envoyer des requêtes HTTP à un serveur et recevoir des réponses du serveur. L’implémentation WinHttpHandler prend en charge les versions HTTP jusqu’à HTTP/2.

WinHttpHandlerest conçu pour être utilisé principalement dans les environnements de serveur par ASP.NET Core et d’autres applications .NET qui communiquent avec les serveurs HTTP. WinHttpHandler fournit également aux développeurs un contrôle plus granulaire sur la communication HTTP de l’application que la HttpClientHandler classe . Cela permet aux développeurs d’implémenter des scénarios HTTP plus avancés ou de modifier les paramètres système par défaut (par exemple, les paramètres de proxy, les délais d’expiration et la validation du certificat SSL du serveur).

WinHttpHandler n’est pas destiné à remplacer HttpClientHandler. Au lieu de cela, il s’agit d’une version plus avancée qui est fournie pour les scénarios où HttpClientHandler est insuffisant. WinHttpHandler est implémenté en tant que wrapper mince sur l’interface WinHTTP de Windows et n’est pris en charge que sur les systèmes Windows.

Lorsque vous utilisez une chaîne de plusieurs gestionnaires, WinHttpHandler doit se trouver au bas de la chaîne.

Cette classe peut également être utilisée dans les applications de bureau en l’installant comme package NuGet. Pour plus d’informations, consultez Package NuGet System.Net.Http.WinHttpHandler.

À compter de .NET 5, WinHttpHandler n’est plus inclus dans l’assembly System.Net.Http.dll dans le cadre du runtime .NET. Pour plus d’informations, consultez WinHttpHandler supprimé du runtime .NET.

Constructeurs

WinHttpHandler()

Initialise une nouvelle instance de la classe WinHttpHandler.

Propriétés

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.

AutomaticRedirection

Obtient ou définit une valeur qui indique si le gestionnaire doit suivre les réponses de redirection HTTP.

CheckCertificateRevocationList

Obtient ou définit une valeur qui indique si la liste de révocation de certificats doit être vérifiée au cours de la validation des certificats SSL.

ClientCertificateOption

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 une collection de certificats SSL d’authentification du client qui sont utilisés pour l’authentification du client par le gestionnaire si la propriété ClientCertificateOption est définie sur Manual.

CookieContainer

Obtient ou définit l’objet conteneur de cookie managé. Cette propriété est utilisée uniquement quand la propriété CookieUsePolicy a la valeur UseSpecifiedCookieContainer. Dans le cas contraire, la méthode SendAsync(HttpRequestMessage, CancellationToken) lève une exception.

CookieUsePolicy

Obtient ou définit une valeur qui indique comment les cookies doivent être gérés et utilisés. Les développeurs peuvent choisir d’ignorer les cookies ou d’autoriser le gestionnaire à les gérer automatiquement ou manuellement à l’aide d’un objet CookieContainer.

DefaultProxyCredentials

Obtient ou définit les informations d’identification utilisées pour authentifier l’utilisateur auprès d’un proxy d’authentification.

EnableMultipleHttp2Connections

Obtient ou définit une valeur qui indique si des connexions HTTP/2 supplémentaires peuvent être établies sur le même serveur lorsque le nombre maximal de flux simultanés est atteint sur toutes les connexions existantes.

MaxAutomaticRedirections

Obtient ou définit le nombre maximal de redirections HTTP autorisées.

MaxConnectionsPerServer

Obtient ou définit le nombre maximal de connexions TCP autorisées à un seul serveur.

MaxResponseDrainSize

Obtient ou définit la quantité maximale de données qui peuvent être purgées à partir des réponses en octets.

MaxResponseHeadersLength

Obtient ou définit la taille maximale de la partie en-tête de la réponse du serveur en octets.

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 le proxy personnalisé quand la propriété WindowsProxyUsePolicy est définie pour utiliser un proxy personnalisé.

ReceiveDataTimeout

Obtient ou définit le délai d’attente pour la réception de la partie données d’une réponse du serveur.

ReceiveHeadersTimeout

Obtient ou définit le délai d’attente pour la réception des en-têtes d’une réponse du serveur.

SendTimeout

Obtient ou définit le délai d’attente pour l’envoi d’une demande.

ServerCertificateValidationCallback

Obtient ou définit une méthode de rappel pour valider le certificat de serveur. Ce rappel fait partie de la négociation SSL.

ServerCredentials

Obtient ou définit les informations d’identification que le client doit utiliser pour s’authentifier auprès du serveur.

SslProtocols

Obtient ou définit la collection de protocoles TLS/SSL pris en charge par le client.

TcpKeepAliveEnabled

Obtient ou définit une valeur indiquant si tcp keep-alive est activé.

TcpKeepAliveInterval

Obtient ou définit l’intervalle de maintien en vie TCP.

TcpKeepAliveTime

Obtient ou définit le délai d’expiration tcp keep-alive.

WindowsProxyUsePolicy

Obtient ou définit le paramètre de proxy. Cette propriété peut être définie pour désactiver le proxy, utiliser un proxy personnalisé ou utiliser les paramètres de proxy de WinHTTP ou WinInet sur l’ordinateur.

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 WinHttpHandler 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)

En cas de substitution dans une classe dérivée, envoie une requête HTTP avec la requête et le jeton d’annulation spécifiés. Sinon, lève un NotSupportedException.

(Hérité de HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)

Envoie une requête HTTP en tant qu’opération asynchrone.

ToString()

Retourne une chaîne qui représente l'objet actuel.

(Hérité de Object)

S’applique à