HttpBaseProtocolFilter Classe

Définition

Filtre de protocole de base pour un instance HttpClient.

public ref class HttpBaseProtocolFilter sealed : IClosable
public ref class HttpBaseProtocolFilter sealed : IClosable, IHttpFilter
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [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)]
class HttpBaseProtocolFilter final : IClosable
/// [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
/// [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.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[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)]
public sealed class HttpBaseProtocolFilter : System.IDisposable
[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
[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
Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposable, IHttpFilter
Héritage
Object Platform::Object IInspectable HttpBaseProtocolFilter
Attributs
Implémente

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.

S’applique à

Voir aussi