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. |
| HttpClientHandler |
Gestionnaire de messages par défaut utilisé par HttpClient dans .NET Framework. |
| HttpContent |
Classe de base représentant un corps d’entité HTTP et des en-têtes de contenu. |
| HttpMessageHandler |
Type de base pour les gestionnaires de messages HTTP. |
| 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. |
| HttpRequestException |
Classe de base pour les exceptions levées par les classes et HttpClient les HttpMessageHandler classes. |
| HttpRequestMessage |
Représente un message de requête HTTP. |
| 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. |
| 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 Windows applications du Windows Store ou d’autres environnements. |
Énumérations
| Nom | Description |
|---|---|
| ClientCertificateOption |
Spécifie la façon dont les certificats clients sont fournis. |
| 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. |
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.