System.Net.Http Namespace

L'espace de noms System.Net.Http fournit une interface de programmation pour les applications HTTP modernes. The System.Net.Http namespace provides a programming interface for modern HTTP applications.

Classes

ByteArrayContent

Fournit du contenu HTTP basé sur un tableau d'octets.Provides HTTP content based on a byte array.

CFNetworkHandler
DelegatingHandler

Type pour les gestionnaires HTTP qui délèguent le traitement des messages de réponse HTTP à un autre gestionnaire, appelé le gestionnaire interne.A type for HTTP handlers that delegate the processing of HTTP response messages to another handler, called the inner handler.

FormUrlEncodedContent

Conteneur pour les tuples nom/valeur encodés en utilisant le type MIME application/x-www-form-urlencoded.A container for name/value tuples encoded using application/x-www-form-urlencoded MIME type.

HttpClient

Fournit une classe de base pour envoyer des requêtes HTTP et recevoir des réponses HTTP d'une ressource identifiée par un URI.Provides a base class for sending HTTP requests and receiving HTTP responses from a resource identified by a URI.

HttpClientHandler

Gestionnaire de messages par défaut utilisé par HttpClient dans le .NET Framework et .NET Core 2.0 et antérieur.The default message handler used by HttpClient in .NET Framework and .NET Core 2.0 and earlier.

HttpContent

Classe de base représentant un corps d'entité HTTP et des en-têtes de contenu.A base class representing an HTTP entity body and content headers.

HttpMessageHandler

Type de base pour les gestionnaires de messages HTTP.A base type for HTTP message handlers.

HttpMessageInvoker

Classe spécialisée qui permet aux applications d’appeler la méthode SendAsync(HttpRequestMessage, CancellationToken) sur une chaîne de gestionnaire HTTP.A specialty class that allows applications to call the SendAsync(HttpRequestMessage, CancellationToken) method on an HTTP handler chain.

HttpMethod

Classe d'assistance pour récupérer et comparer les méthodes HTTP standard et pour créer de nouvelles méthodes HTTP.A helper class for retrieving and comparing standard HTTP methods and for creating new HTTP methods.

HttpRequestException

Classe de base pour les exceptions levées par les classes HttpClient et HttpMessageHandler .A base class for exceptions thrown by the HttpClient and HttpMessageHandler classes.

HttpRequestMessage

Représente un message de requête HTTP.Represents a HTTP request message.

HttpResponseMessage

Représente un message de réponse HTTP, y compris le code d’état et les données.Represents a HTTP response message including the status code and data.

MessageProcessingHandler

Type de base pour les gestionnaires qui traitent uniquement des messages de demande et/ou de réponse.A base type for handlers which only do some small processing of request and/or response messages.

MultipartContent

Fournit une collection d'objets HttpContent qui sont sérialisés à l'aide de la spécification de type de contenu multipart/*.Provides a collection of HttpContent objects that get serialized using the multipart/* content type specification.

MultipartFormDataContent

Fournit un conteneur pour le contenu encodé à l'aide du type MIME multipart/form-data.Provides a container for content encoded using multipart/form-data MIME type.

NSUrlSessionHandler
ReadOnlyMemoryContent
RtcRequestFactory
SocketsHttpHandler

Fournit le Gestionnaire de messages par défaut utilisé par HttpClient dans .NET Core 2.1 et ultérieur.Provides the default message handler used by HttpClient in .NET Core 2.1 and later.

StreamContent

Fournit du contenu HTTP basé sur un flux.Provides HTTP content based on a stream.

StringContent

Fournit du contenu HTTP basé sur une chaîne.Provides HTTP content based on a string.

WebRequestHandler

Fournit les fonctionnalités spécifiques au bureau non disponibles pour les applications Windows Store ou d'autres environnements.Provides desktop-specific features not available to Windows Store apps or other environments.

WinHttpHandler

WinHttpHandler est un gestionnaire de messages spécialisé basé sur l’interface WinHTTP de Windows et conçu pour une utilisation dans des environnements serveur.WinHttpHandler is a specialty message handler based on the WinHTTP interface of Windows and is intended for use in server environments. Cette classe peut également être utilisée dans les applications de bureau en l’installant comme package NuGet.This class is also available for use in Desktop apps by installing it as a NuGet package. Pour plus d’informations sur l’installation de cette classe en vue de l’utiliser dans les applications de bureau, consultez System.Net.Http.WinHttpHandler.For more information about installing this class for use in Desktop apps, see System.Net.Http.WinHttpHandler.

Énumérations

ClientCertificateOption

Spécifie la façon dont les certificats clients sont fournis.Specifies how client certificates are provided.

CookieUsePolicy

Cette énumération permet de contrôler les cookies HTTP lors de communications avec le serveur.This enumeration allows control of HTTP cookies when communicating with the server.

HttpCompletionOption

Indique si les opérations HttpClient doivent être considérées comme étant terminées dès qu'une réponse est disponible, ou après avoir pris connaissance de l'intégralité du message de réponse intégrant le contenu.Indicates if HttpClient operations should be considered completed either as soon as a response is available, or after reading the entire response message including the content.

WindowsProxyUsePolicy

Cette énumération fournit les options disponibles pour les paramètres de proxy utilisés par un HttpClient lors de l’exécution sur Windows.This enumeration provides available options for the proxy settings used by an HttpClient when running on Windows.

Remarques

Le System.Net.Http espace de noms est conçu pour fournir les informations suivantes :The System.Net.Http namespace is designed to provide the following:

  1. Composants de client HTTP qui permettent aux utilisateurs de consommer des services web modernes sur HTTP.HTTP client components that allow users to consume modern web services over HTTP.

  2. Composants HTTP peuvent être utilisés par les clients et serveurs (en-têtes HTTP et les messages, par exemple).HTTP components that can be used by both clients and servers (HTTP headers and messages, for example). Cela fournit un modèle de programmation cohérent sur le client et côté serveur pour les services web modernes sur HTTP.This provides a consistent programming model on both the client and the server side for modern web services over HTTP.

Le System.Net.Http espace de noms et aux propriétés connexes System.Net.Http.Headers espace de noms fournissent un ensemble de composants suivant :The System.Net.Http namespace and the related System.Net.Http.Headers namespace provide the following set of components:

  1. HttpClient -la classe principale utilisée pour envoyer et recevoir des demandes via HTTP.HttpClient - the primary class used to send and receive requests over HTTP.

  2. HttpRequestMessage et HttpResponseMessage -des messages HTTP comme défini dans RFC 2616 par l’IETF.HttpRequestMessage and HttpResponseMessage - HTTP messages as defined in RFC 2616 by the IETF.

  3. HttpHeaders -En-têtes comme défini dans RFC 2616 par l’IETF.HttpHeaders - HTTP headers as defined in RFC 2616 by the IETF.

  4. HttpClientHandler -Gestionnaires HTTP chargés de produire des messages de réponse HTTP.HttpClientHandler - HTTP handlers responsible for producing HTTP response messages.

Il existe divers handles de message HTTP peuvent être utilisés.There are various HTTP message handles that can be used. Citons notamment les éléments suivants.These include the following.

  1. DelegatingHandler -Une classe utilisée pour connecter un gestionnaire à une chaîne de gestionnaire.DelegatingHandler - A class used to plug a handler into a handler chain.

  2. HttpMessageHandler -Un simple à la classe à dériver de qui prend en charge les spécifications les plus courantes pour la plupart des applications.HttpMessageHandler - A simple to class to derive from that supports the most common requirements for most applications.

  3. HttpClientHandler -Une classe qui opère en bas de la chaîne de gestionnaire qui gère en fait les opérations de transport HTTP.HttpClientHandler - A class that operates at the bottom of the handler chain that actually handles the HTTP transport operations.

  4. WebRequestHandler -Une classe spécialisée qui opère en bas de la classe de chaîne de gestionnaire qui gère les opérations de transport HTTP avec des options qui sont spécifiques à la System.Net.HttpWebRequest objet.WebRequestHandler - A specialty class that operates at the bottom of the handler chain class that handles HTTP transport operations with options that are specific to the System.Net.HttpWebRequest object.

Le contenu d’un message HTTP correspond au corps d’entité défini dans RFC 2616.The contents of an HTTP message corresponds to the entity body defined in RFC 2616.

Plusieurs classes de peut être utilisé pour le contenu HTTP.A number of classes can be used for HTTP content. Citons notamment les éléments suivants.These include the following.

  1. ByteArrayContent -Contenu HTTP basé sur un tableau d’octets.ByteArrayContent - HTTP content based on a byte array.

  2. FormUrlEncodedContent -Contenu HTTP de tuples nom/valeur encodés à l’aide d’application/x--www-form-urlencoded type MIME.FormUrlEncodedContent - HTTP content of name/value tuples encoded using application/x-www-form-urlencoded MIME type.

  3. MultipartContent -Contenu HTTP sérialisé à l’aide de la multipart / * spécification du type de contenu.MultipartContent - HTTP content that gets serialized using the multipart/* content type specification.

  4. MultipartFormDataContent -Contenu HTTP encodé à l’aide de type MIME multipart/form-data.MultipartFormDataContent - HTTP content encoded using the multipart/form-data MIME type.

  5. StreamContent -Contenu HTTP basé sur un flux de données.StreamContent - HTTP content based on a stream.

  6. StringContent -Contenu HTTP basé sur une chaîne.StringContent - HTTP content based on a string.

Si une application à l’aide de la System.Net.Http et System.Net.Http.Headers espaces de noms a l’intention de télécharger de grandes quantités de données (50 mégaoctets ou plus), puis l’application doit diffuser ces téléchargements et pas utiliser la mise en mémoire tampon par défaut.If an app using the System.Net.Http and System.Net.Http.Headers namespaces intends to download large amounts of data (50 megabytes or more), then the app should stream those downloads and not use the default buffering. Si la mise en mémoire tampon par défaut est utilisé, l’utilisation de la mémoire client obtiendra très volumineuse, pouvant provoquer le sensiblement réduit les performances.If the default buffering is used the client memory usage will get very large, potentially resulting in substantially reduced performance.

Classes dans le System.Net.Http et System.Net.Http.Headers espaces de noms peuvent être utilisés pour développer des applications du Windows Store ou les applications de bureau.Classes in the System.Net.Http and System.Net.Http.Headers namespaces can be used to develop Windows Store apps or desktop apps. Si elles sont utilisées dans une application Windows Store, les classes dans le System.Net.Http et System.Net.Http.Headers espaces de noms sont affectées par la fonctionnalité d’isolement réseau, partie du modèle de sécurité d’application utilisé par le Windows 8Windows 8.When used in a Windows Store app, classes in the System.Net.Http and System.Net.Http.Headers namespaces are affected by network isolation feature, part of the application security model used by the Windows 8Windows 8. Les fonctionnalités réseau appropriées doivent être activées dans le manifeste d’application pour une application Windows Store pour le système autoriser l’accès réseau par une application du Windows store.The appropriate network capabilities must be enabled in the app manifest for a Windows Store app for the system to allow network access by a Windows store app. Pour plus d’informations, consultez Isolement réseau pour les applications du Windows Store.For more information, see the Network Isolation for Windows Store Apps.