System.Net.Http Namespace

Lo spazio dei nomi System.Net.Http fornisce un'interfaccia di programmazione per le applicazioni HTTP attuali. The System.Net.Http namespace provides a programming interface for modern HTTP applications.

Classi

ByteArrayContent

Fornisce il contenuto HTTP basato su una matrice di byte.Provides HTTP content based on a byte array.

CFNetworkHandler
DelegatingHandler

Tipo per gestori HTTP che delegano l'elaborazione dei messaggi di risposta HTTP a un altro gestore, chiamato gestore interno.A type for HTTP handlers that delegate the processing of HTTP response messages to another handler, called the inner handler.

FormUrlEncodedContent

Contenitore per le tuple nome/valore codificate utilizzando il tipo MIME application/x-www-form-urlencoded.A container for name/value tuples encoded using application/x-www-form-urlencoded MIME type.

HttpClient

Fornisce una classe base per l'invio di richieste HTTP e la ricezione di risposte HTTP da una risorsa identificata da un URI.Provides a base class for sending HTTP requests and receiving HTTP responses from a resource identified by a URI.

HttpClientHandler

Il gestore di messaggi predefinito usato da HttpClient.NET Framework e .NET Core 2.0 e versioni precedenti.The default message handler used by HttpClient in .NET Framework and .NET Core 2.0 and earlier.

HttpContent

Classe base che rappresenta un corpo di entità e intestazioni di contenuto HTTP.A base class representing an HTTP entity body and content headers.

HttpMessageHandler

Tipo di base per i gestori di messaggi HTTP.A base type for HTTP message handlers.

HttpMessageInvoker

Classe di specializzazione che consente alle applicazioni di chiamare il metodo SendAsync(HttpRequestMessage, CancellationToken) su una catena del gestore HTTP.A specialty class that allows applications to call the SendAsync(HttpRequestMessage, CancellationToken) method on an HTTP handler chain.

HttpMethod

Classe di helper per recuperare e confrontare i metodi HTTP standard e per creare nuovi metodi HTTP.A helper class for retrieving and comparing standard HTTP methods and for creating new HTTP methods.

HttpRequestException

Classe base per eccezioni generate dalle classi HttpClient e HttpMessageHandler.A base class for exceptions thrown by the HttpClient and HttpMessageHandler classes.

HttpRequestMessage

Rappresenta un messaggio di richiesta HTTP.Represents a HTTP request message.

HttpResponseMessage

Rappresenta un messaggio di risposta HTTP che include il codice di stato e i dati.Represents a HTTP response message including the status code and data.

MessageProcessingHandler

Tipo di base per gestori che possono elaborare soltanto piccole richieste e/o messaggi di risposta.A base type for handlers which only do some small processing of request and/or response messages.

MultipartContent

Fornisce una raccolta di oggetti HttpContent che vengono serializzati utilizzando la specifica di tipo di contenuto multipart/*.Provides a collection of HttpContent objects that get serialized using the multipart/* content type specification.

MultipartFormDataContent

Fornisce un contenitore per contenuto codificato utilizzando il tipo MIME multipart/form-data.Provides a container for content encoded using multipart/form-data MIME type.

NSUrlSessionHandler

Gestore di messaggi predefinito usato da HttpClient sulle piattaforme Apple che usano lo stack Xamarin (iOS, MacOS, watchOS, tvOS)The default message handler used by HttpClient on Apple platforms using the Xamarin stack (iOS, macOS, watchOS, tvOS)

ReadOnlyMemoryContent
RtcRequestFactory
SocketsHttpHandler

Fornisce il gestore di messaggi predefinito usato da HttpClient in .NET Core 2.1 e versioni successive.Provides the default message handler used by HttpClient in .NET Core 2.1 and later.

StreamContent

Fornisce il contenuto HTTP basato su un flusso.Provides HTTP content based on a stream.

StringContent

Fornisce il contenuto HTTP basato su una stringa.Provides HTTP content based on a string.

WebRequestHandler

Fornisce funzionalità specifiche del desktop non disponibili per le App Windows Store o altri ambienti.Provides desktop-specific features not available to Windows Store apps or other environments.

WinHttpHandler

WinHttpHandler è un gestore di messaggi specializzato basato sull'interfaccia WinHTTP di Windows ed è destinato all'uso in ambienti server.WinHttpHandler is a specialty message handler based on the WinHTTP interface of Windows and is intended for use in server environments. Questa classe è disponibile anche per l'uso nelle app desktop tramite l'installazione come pacchetto NuGet.This class is also available for use in Desktop apps by installing it as a NuGet package. Per altre informazioni sull'installazione di questa classe per l'uso nelle app desktop, vedere System.Net.Http.WinHttpHandler.For more information about installing this class for use in Desktop apps, see System.Net.Http.WinHttpHandler.

Enumerazioni

ClientCertificateOption

Specifica come i certificati client vengono forniti.Specifies how client certificates are provided.

CookieUsePolicy

Questa enumerazione consente il controllo dei cookie HTTP durante la comunicazione con il server.This enumeration allows control of HTTP cookies when communicating with the server.

HttpCompletionOption

Indica se le operazioni di HttpClient devono essere considerate completate non appena la risposta è disponibile o dopo la lettura dell'intero messaggio di risposta, incluso il contenuto.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

Questa enumerazione fornisce le opzioni disponibili per le impostazioni proxy usate da un HttpClient durante l'esecuzione in Windows.This enumeration provides available options for the proxy settings used by an HttpClient when running on Windows.

Commenti

Il System.Net.Http dello spazio dei nomi è progettata per offrire quanto segue:The System.Net.Http namespace is designed to provide the following:

  1. Componenti client HTTP che consentono agli utenti di utilizzare i servizi web moderni su HTTP.HTTP client components that allow users to consume modern web services over HTTP.

  2. I componenti HTTP che possono essere utilizzati dal computer client e server (le intestazioni HTTP e i messaggi, ad esempio).HTTP components that can be used by both clients and servers (HTTP headers and messages, for example). Ciò fornisce un modello di programmazione coerente sul client e lato server per i servizi web moderni su HTTP.This provides a consistent programming model on both the client and the server side for modern web services over HTTP.

Il System.Net.Http dello spazio dei nomi e i relativi System.Net.Http.Headers dello spazio dei nomi presentano i seguenti componenti:The System.Net.Http namespace and the related System.Net.Http.Headers namespace provide the following set of components:

  1. HttpClient -la classe primaria utilizzata per inviare e ricevere le richieste tramite HTTP.HttpClient - the primary class used to send and receive requests over HTTP.

  2. HttpRequestMessage e HttpResponseMessage -dei messaggi HTTP come definito in RFC 2616 da IETF.HttpRequestMessage and HttpResponseMessage - HTTP messages as defined in RFC 2616 by the IETF.

  3. HttpHeaders -Intestazioni HTTP come definito in RFC 2616 da IETF.HttpHeaders - HTTP headers as defined in RFC 2616 by the IETF.

  4. HttpClientHandler -HTTP handlers responsabili della produzione di messaggi di risposta HTTP.HttpClientHandler - HTTP handlers responsible for producing HTTP response messages.

Esistono vari gli handle di messaggio HTTP che possono essere utilizzati.There are various HTTP message handles that can be used. Questi includono quanto segue.These include the following.

  1. DelegatingHandler -Una classe utilizzata per collegare un gestore di una catena del gestore.DelegatingHandler - A class used to plug a handler into a handler chain.

  2. HttpMessageHandler -Un semplice alla classe derivandola da che supportino i requisiti più comuni per la maggior parte delle applicazioni.HttpMessageHandler - A simple to class to derive from that supports the most common requirements for most applications.

  3. HttpClientHandler -Una classe che viene eseguito nella parte inferiore della catena del gestore che gestisce le operazioni di trasporto HTTP.HttpClientHandler - A class that operates at the bottom of the handler chain that actually handles the HTTP transport operations.

  4. WebRequestHandler -Classe di specializzazione che opera a fondo la classe di catena del gestore che gestisce le operazioni di trasporto HTTP con le opzioni specifiche per il System.Net.HttpWebRequest oggetto.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.

Il contenuto di un messaggio HTTP corrisponde al corpo dell'entità definito in RFC 2616.The contents of an HTTP message corresponds to the entity body defined in RFC 2616.

Una serie di classi è utilizzabile per il contenuto HTTP.A number of classes can be used for HTTP content. Questi includono quanto segue.These include the following.

  1. ByteArrayContent -Contenuto HTTP in base a una matrice di byte.ByteArrayContent - HTTP content based on a byte array.

  2. FormUrlEncodedContent -Contenuto HTTP di tuple nome/valore codificate tramite application/x-www-form-urlencoded tipo MIME.FormUrlEncodedContent - HTTP content of name/value tuples encoded using application/x-www-form-urlencoded MIME type.

  3. MultipartContent -Contenuto HTTP che viene serializzato usando il multipart / * specifica del tipo di contenuto.MultipartContent - HTTP content that gets serialized using the multipart/* content type specification.

  4. MultipartFormDataContent -HTTP contenuto codificato utilizzando il tipo MIME multipart/form-data.MultipartFormDataContent - HTTP content encoded using the multipart/form-data MIME type.

  5. StreamContent -Contenuto HTTP in base a un flusso.StreamContent - HTTP content based on a stream.

  6. StringContent -Contenuto HTTP in base a una stringa.StringContent - HTTP content based on a string.

Se un'app usando il System.Net.Http e System.Net.Http.Headers gli spazi dei nomi si propone di scaricare grandi quantità di dati (50 megabyte o più), quindi l'app deve trasmettere questi download e non usare la memorizzazione nel buffer predefinita.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. Se la memorizzazione nel buffer predefinita viene usato l'utilizzo della memoria client verrà visualizzato molto grande, comportando potenziale sostanzialmente una riduzione delle prestazioni.If the default buffering is used the client memory usage will get very large, potentially resulting in substantially reduced performance.

Le classi di System.Net.Http e System.Net.Http.Headers gli spazi dei nomi può essere utilizzato per sviluppare app di Windows Store o App desktop.Classes in the System.Net.Http and System.Net.Http.Headers namespaces can be used to develop Windows Store apps or desktop apps. Se usato in un'app Windows Store, le classi nel System.Net.Http e System.Net.Http.Headers spazi dei nomi sono interessate dalla funzionalità di isolamento rete, parte del modello di sicurezza dell'applicazione utilizzato dal 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. Le funzionalità di rete appropriata devono essere abilitate nel manifesto dell'app per un'app di Windows Store per il sistema consentire l'accesso alla rete da un'app di 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. Per altre informazioni, vedere Network Isolation for Windows Store Apps (Isolamento rete per le app di Windows Store).For more information, see the Network Isolation for Windows Store Apps.