HttpBaseProtocolFilter Classe

Définition

Espace de noms:

Windows.Web.Http.Filters

Filtre de protocole de base pour un instance HttpClient.

public ref class HttpBaseProtocolFilter sealed : IClosable, IHttpFilter

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpBaseProtocolFilter final : IClosable, IHttpFilter

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpBaseProtocolFilter : System.IDisposable, IHttpFilter

function HttpBaseProtocolFilter()

Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposable, IHttpFilter

Héritage

Object Platform::Object IInspectable HttpBaseProtocolFilter

Attributs

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implémente

IClosable IDisposable IHttpFilter

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

La classe HttpBaseProtocolFilter fournit le filtre de base ou le gestionnaire utilisé par un instance HttpClient. Si aucun filtre supplémentaire n’est ajouté à l’instance HttpClient, l’objet HttpBaseProtocolFilter est le seul filtre.

La classe HttpBaseProtocolFilter fournit un ensemble de propriétés permettant de basculer différents comportements de pile HTTP de bas niveau.

Des filtres supplémentaires basés sur l’interface IHttpFilter peuvent être ajoutés à la chaîne de filtres appliquée à un instance HttpClient qui peut gérer ou traiter davantage les résultats de l’objet HttpBaseProtocolFilter.

L’objet HttpBaseProtocolFilter lève des exceptions lors de l’envoi de requêtes HTTP ou de la réception de réponses et des défaillances réseau se produisent (perte de connectivité en mode avion, par exemple). Les développeurs qui utilisent HttpClient dans les applications peuvent préférer ajouter un filtre pour intercepter ces exceptions et les convertir en codes de réponse HTTP à la place.

Historique des versions

Version de Windows	Version du SDK	Valeur ajoutée
1511	10586	CookieUsageBehavior
1607	14393	ClearAuthenticationCache
1607	14393	ServerCustomValidationRequested
1903	18362	CreateForUser
1903	18362	Utilisateur

Constructeurs

HttpBaseProtocolFilter()

Initialise une nouvelle instance de la classe HttpBaseProtocolFilter. Dans une application de bureau, avant d’utiliser une instance de cette classe d’une manière qui affiche l’interface utilisateur, vous devez associer l’objet au handle de fenêtre de son propriétaire. Pour plus d’informations et des exemples de code, consultez Afficher des objets d’interface utilisateur WinRT qui dépendent de CoreWindow.

Propriétés

AllowAutoRedirect	Obtenez ou définissez une valeur qui indique si HttpBaseProtocolFilter doit suivre les réponses de redirection.
AllowUI	Obtenez ou définissez une valeur qui indique si HttpBaseProtocolFilter peut demander des informations d’identification de l’utilisateur lorsque le serveur le demande.
AutomaticDecompression	Obtient ou définit une valeur qui indique si HttpBaseProtocolFilter peut décompresser automatiquement la réponse de contenu HTTP.
CacheControl	Obtenez ou définissez le comportement de contrôle de cache en lecture et en écriture à utiliser sur l’objet HttpBaseProtocolFilter .
ClientCertificate	Obtenez ou définissez le certificat SSL client qui sera envoyé au serveur si le serveur demande un certificat client.
CookieManager	Obtenez le HttpCookieManager avec les cookies associés à une application.
CookieUsageBehavior	Obtient ou définit le comportement d’utilisation des cookies. Par défaut, les cookies sont gérés automatiquement.
IgnorableServerCertificateErrors	Obtenez un vecteur d’erreurs de certificat de serveur SSL que l’application peut choisir d’ignorer par la suite.
MaxConnectionsPerServer	Obtenez ou définissez le nombre maximal de connexions TCP autorisées par serveur HTTP par l’objet HttpBaseProtocolFilter .
MaxVersion	Obtient ou définit la version du protocole HTTP utilisé.
ProxyCredential	Obtenez ou définissez les informations d’identification à utiliser pour négocier avec un proxy HTTP.
ServerCredential	Obtenez ou définissez les informations d’identification à utiliser pour l’authentification auprès d’un serveur HTTP.
UseProxy	Obtenez ou définissez une valeur qui indique si HttpBaseProtocolFilter peut utiliser un proxy pour envoyer des requêtes HTTP.
User	Obtient l’utilisateur associé à HttpBaseProtocolFilter.

Méthodes

ClearAuthenticationCache()	Efface les informations d’identification d’authentification actuellement mises en cache sur l’appareil.
Close()	Ferme l’instance HttpBaseProtocolFilter et libère les ressources allouées.
CreateForUser(User)	Crée un httpBaseProtocolFilter pour un utilisateur spécifique.
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées.
SendRequestAsync(HttpRequestMessage)	Envoyez une requête HTTP à l’aide de HttpBaseProtocolFilter en tant qu’opération asynchrone.

Événements

ServerCustomValidationRequested

Cet événement est déclenché lorsque la connexion SSL/TLS est établie avec le serveur. Vous devez implémenter un gestionnaire d’événements pour cet événement si vous devez effectuer une validation supplémentaire (en plus de la valeur par défaut du système d’exploitation) du certificat SSL du serveur.

Voir aussi

• IClosable
• IHttpFilter