System.Net.Http Espace de noms
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.
Fournit une interface de programmation pour les applications HTTP modernes.
Classes
| Nom | Description |
|---|---|
| ByteArrayContent |
Fournit du contenu HTTP basé sur un tableau d’octets. |
| DelegatingHandler |
Type pour les gestionnaires HTTP qui délèguent le traitement des messages de réponse HTTP à un autre gestionnaire, appelé gestionnaire interne. |
| FormUrlEncodedContent |
Conteneur pour les tuples nom/valeur encodés à l’aide du type MIME application/x-www-form-urlencoded. |
| HttpClient |
Fournit une classe pour l’envoi de requêtes HTTP et la réception de réponses HTTP à partir d’une ressource identifiée par un URI. |
| HttpClientFactoryExtensions |
Méthodes d’extensions pour IHttpClientFactory. |
| HttpClientHandler |
Gestionnaire de messages par défaut utilisé dans HttpClient .NET Framework et .NET Core 2.0 et versions antérieures. |
| HttpContent |
Classe de base représentant un corps d’entité HTTP et des en-têtes de contenu. |
| HttpDiagnosticsHttpRequestMessageExtensions |
Extensions pour les utilitaires de télémétrie. |
| HttpIOException |
Exception levée lorsqu’une erreur se produit lors de la lecture de la réponse. |
| HttpMessageHandler |
Type de base pour les gestionnaires de messages HTTP. |
| HttpMessageHandlerFactoryExtensions |
Méthodes d’extensions pour IHttpMessageHandlerFactory. |
| HttpMessageInvoker |
Classe spécialisée qui permet aux applications d’appeler la SendAsync(HttpRequestMessage, CancellationToken) méthode sur une chaîne de gestionnaires HTTP. |
| HttpMethod |
Classe d’assistance pour la récupération et la comparaison des méthodes HTTP standard et la création de nouvelles méthodes HTTP. |
| HttpProtocolException |
Exception levée lorsqu’une erreur de protocole HTTP/2 ou HTTP/3 se produit. |
| HttpRequestException |
Classe de base pour les exceptions levées par les classes et HttpMessageHandler les HttpClient classes. |
| HttpRequestMessage |
Représente un message de requête HTTP. |
| HttpRequestOptions |
Représente une collection d’options pour une requête HTTP. |
| HttpResilienceHttpRequestMessageExtensions |
Extensions de résilience pour HttpRequestMessage. |
| HttpResponseMessage |
Représente un message de réponse HTTP, y compris le code d’état et les données. |
| MessageProcessingHandler |
Type de base pour les gestionnaires qui effectuent uniquement un petit traitement des messages de demande et/ou de réponse. |
| MultipartContent |
Fournit une collection d’objets HttpContent qui sont sérialisés à l’aide de la spécification de type de contenu multipart/* . |
| MultipartFormDataContent |
Fournit un conteneur pour le contenu encodé à l’aide du type MIME multipart/form-data. |
| ReadOnlyMemoryContent |
Fournit du contenu HTTP basé sur un ReadOnlyMemory<T>. |
| RtcRequestFactory |
Fournit une interface de programmation pour les applications HTTP modernes. |
| SocketsHttpConnectionContext |
Représente le contexte passé à l’instance d’une ConnectCallbackSocketsHttpHandler instance. . |
| SocketsHttpHandler |
Fournit le gestionnaire de messages par défaut utilisé dans HttpClient .NET Core 2.1 et versions ultérieures. |
| SocketsHttpPlaintextStreamFilterContext |
Représente le contexte passé au PlaintextStreamFilter pour une instance SocketsHttpHandler. |
| StreamContent |
Fournit du contenu HTTP basé sur un flux. |
| StringContent |
Fournit du contenu HTTP basé sur une chaîne. |
| WebRequestHandler |
Fournit des fonctionnalités spécifiques au bureau non disponibles pour les applications du Windows Store ou d’autres environnements. |
| WinHttpHandler |
Gère les messages basés sur l’interface WinHTTP de Windows. Cette classe est destinée à être utilisée dans les environnements serveur. |
Structures
| Nom | Description |
|---|---|
| HttpRequestOptionsKey<TValue> |
Représente une clé dans la collection d’options pour une requête HTTP. |
Interfaces
| Nom | Description |
|---|---|
| IHttpClientFactory |
Abstraction de fabrique pour un composant qui peut créer HttpClient des instances avec une configuration personnalisée pour un nom logique donné. |
| IHttpMessageHandlerFactory |
Abstraction de fabrique pour un composant qui peut créer HttpMessageHandler des instances avec une configuration personnalisée pour un nom logique donné. |
Énumérations
| Nom | Description |
|---|---|
| ClientCertificateOption |
Spécifie la façon dont les certificats clients sont fournis. |
| CookieUsePolicy |
Cette énumération permet de contrôler les cookies HTTP lors de la communication avec le serveur. |
| HttpCompletionOption |
Indique si HttpClient opérations doivent être considérées comme terminées dès qu’une réponse est disponible ou après avoir lu l’intégralité du message de réponse, y compris le contenu. |
| HttpKeepAlivePingPolicy |
Spécifie quand la trame ping HTTP/2 est envoyée sur une connexion inactive. |
| HttpRequestError |
Définit les catégories d’erreurs représentant la raison de HttpRequestException ou de HttpIOException. |
| HttpVersionPolicy |
Spécifie les comportements de sélection et de négociation de la version HTTP d’une requête. |
| WindowsProxyUsePolicy |
Cette énumération fournit des options disponibles pour les paramètres de proxy utilisés par un HttpClient lors de l’exécution sur Windows. |
Délégués
| Nom | Description |
|---|---|
| HeaderEncodingSelector<TContext> |
Représente une méthode qui spécifie l’encodage à utiliser lors de l’interprétation des valeurs d’en-tête. |
Remarques
L’espace System.Net.Http de noms est conçu pour fournir les composants suivants :
- Composants clients HTTP qui permettent aux utilisateurs d’utiliser des services web modernes via HTTP.
- Composants HTTP qui peuvent être utilisés par les clients et les serveurs (en-têtes ET messages HTTP, par exemple). Cela fournit un modèle de programmation cohérent côté client et côté serveur pour les services web modernes via HTTP.
L’espace System.Net.Http de noms et l’espace de noms associé System.Net.Http.Headers fournissent l’ensemble de composants suivant :
- HttpClient - Classe primaire utilisée pour envoyer et recevoir des requêtes via HTTP.
- HttpRequestMessage et HttpResponseMessage - Messages HTTP définis dans RFC 2616 par l’IETF.
- HttpHeaders - En-têtes HTTP définis dans RFC 2616 par l’IETF.
- HttpClientHandler - Gestionnaires HTTP chargés de produire des messages de réponse HTTP.
Il existe différents gestionnaires de messages HTTP que vous pouvez utiliser :
- DelegatingHandler - Classe utilisée pour brancher un gestionnaire dans une chaîne de gestionnaires.
- HttpMessageHandler - Classe simple à dériver de celle-ci prend en charge les exigences les plus courantes pour la plupart des applications.
- HttpClientHandler - Classe qui fonctionne en bas de la chaîne de gestionnaires qui gère réellement les opérations de transport HTTP.
Le contenu d’un message HTTP correspond au corps d’entité défini dans RFC 2616.
Les classes suivantes peuvent être utilisées pour le contenu HTTP :
- ByteArrayContent - Contenu HTTP basé sur un tableau d’octets.
- FormUrlEncodedContent - Contenu HTTP des tuples nom/valeur encodés à l’aide du type MIME application/x-www-form-urlencoded.
- MultipartContent - Contenu HTTP sérialisé à l’aide de la spécification de type de contenu multipart/* .
- MultipartFormDataContent - Contenu HTTP encodé à l’aide du type MIME multipart/form-data.
- StreamContent - Contenu HTTP basé sur un flux.
- StringContent - Contenu HTTP basé sur une chaîne.
Si votre application utilise les System.Net.Http espaces de noms et System.Net.Http.Headers a l’intention de télécharger de grandes quantités de données (50 mégaoctets ou plus), elle doit diffuser en continu ces téléchargements et ne pas utiliser la mise en mémoire tampon par défaut. Si vous utilisez la mise en mémoire tampon par défaut, l’utilisation de la mémoire client est très importante, ce qui peut entraîner une réduction substantielle des performances.
