WinHttpHandler Classe
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.
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 est similaire à d’autres classes existantes telles que HttpClientHandler. WinHttpHandlerfournit un gestionnaire sous un 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.
Win |
Initialise une nouvelle instance de la classe WinHttpHandler. |
Automatic |
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. |
Automatic |
Obtient ou définit une valeur qui indique si le gestionnaire doit suivre les réponses de redirection HTTP. |
Check |
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. |
Client |
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. |
Client |
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 |
Cookie |
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. |
Cookie |
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. |
Default |
Obtient ou définit les informations d’identification utilisées pour authentifier l’utilisateur auprès d’un proxy d’authentification. |
Enable |
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. |
Max |
Obtient ou définit le nombre maximal de redirections HTTP autorisées. |
Max |
Obtient ou définit le nombre maximal de connexions TCP autorisées à un seul serveur. |
Max |
Obtient ou définit la quantité maximale de données qui peuvent être purgées à partir des réponses en octets. |
Max |
Obtient ou définit la taille maximale de la partie en-tête de la réponse du serveur en octets. |
Pre |
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é. |
Receive |
Obtient ou définit le délai d’attente pour la réception de la partie données d’une réponse du serveur. |
Receive |
Obtient ou définit le délai d’attente pour la réception des en-têtes d’une réponse du serveur. |
Send |
Obtient ou définit le délai d’attente pour l’envoi d’une demande. |
Server |
Obtient ou définit une méthode de rappel pour valider le certificat de serveur. Ce rappel fait partie de la négociation SSL. |
Server |
Obtient ou définit les informations d’identification que le client doit utiliser pour s’authentifier auprès du serveur. |
Ssl |
Obtient ou définit la collection de protocoles TLS/SSL pris en charge par le client. |
Tcp |
Obtient ou définit une valeur indiquant si tcp keep-alive est activé. |
Tcp |
Obtient ou définit l’intervalle de maintien en vie TCP. |
Tcp |
Obtient ou définit le délai d’expiration tcp keep-alive. |
Windows |
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. |
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) |
Get |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
Get |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
Memberwise |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
Send(Http |
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) |
Send |
Envoie une requête HTTP en tant qu’opération asynchrone. |
To |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Produit | Versions |
---|---|
.NET | Core 1.0, Core 1.1 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :