System.Net.Http Spazio dei nomi
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Fornisce un'interfaccia di programmazione per le applicazioni HTTP moderne.
Classi
| Nome | Descrizione |
|---|---|
| ByteArrayContent |
Fornisce contenuto HTTP basato su una matrice di byte. |
| DelegatingHandler |
Tipo per i gestori HTTP che delegano l'elaborazione dei messaggi di risposta HTTP a un altro gestore, denominato gestore interno. |
| FormUrlEncodedContent |
Contenitore per tuple nome/valore codificate con il tipo MIME application/x-www-form-urlencoded. |
| HttpClient |
Fornisce una classe per l'invio di richieste HTTP e la ricezione di risposte HTTP da una risorsa identificata da un URI. |
| HttpClientHandler |
Gestore di messaggi predefinito usato da HttpClient in .NET Framework. |
| HttpContent |
Classe di base che rappresenta un corpo dell'entità HTTP e le intestazioni del contenuto. |
| HttpMessageHandler |
Tipo di base per i gestori di messaggi HTTP. |
| HttpMessageInvoker |
Classe specializzata che consente alle applicazioni di chiamare il SendAsync(HttpRequestMessage, CancellationToken) metodo su una catena di gestori HTTP. |
| HttpMethod |
Classe helper per il recupero e il confronto di metodi HTTP standard e per la creazione di nuovi metodi HTTP. |
| HttpRequestException |
Classe di base per le eccezioni generate dalle HttpClient classi e HttpMessageHandler . |
| HttpRequestMessage |
Rappresenta un messaggio di richiesta HTTP. |
| HttpResponseMessage |
Rappresenta un messaggio di risposta HTTP che include il codice di stato e i dati. |
| MessageProcessingHandler |
Tipo di base per i gestori che eseguono solo alcune piccole elaborazioni di messaggi di richiesta e/o risposta. |
| MultipartContent |
Fornisce una raccolta di HttpContent oggetti che vengono serializzati usando la specifica del tipo di contenuto multipart/*. |
| MultipartFormDataContent |
Fornisce un contenitore per il contenuto codificato usando il tipo MIME multipart/form-data. |
| ReadOnlyMemoryContent |
Fornisce contenuto HTTP basato su un oggetto ReadOnlyMemory<T>. |
| RtcRequestFactory |
Fornisce un'interfaccia di programmazione per le applicazioni HTTP moderne. |
| StreamContent |
Fornisce contenuto HTTP basato su un flusso. |
| StringContent |
Fornisce contenuto HTTP basato su una stringa. |
| WebRequestHandler |
Fornisce funzionalità specifiche del desktop non disponibili per Windows app dello Store o altri ambienti. |
Enumerazioni
| Nome | Descrizione |
|---|---|
| ClientCertificateOption |
Specifica il modo in cui vengono forniti i certificati client. |
| HttpCompletionOption |
Indica se HttpClient operazioni devono essere considerate completate non appena è disponibile una risposta o dopo aver letto l'intero messaggio di risposta, incluso il contenuto. |
Commenti
Lo System.Net.Http spazio dei nomi è progettato per fornire i componenti seguenti:
- Componenti client HTTP che consentono agli utenti di utilizzare servizi Web moderni tramite HTTP.
- Componenti HTTP che possono essere usati sia da client che da server (intestazioni HTTP e messaggi, ad esempio). In questo modo viene fornito un modello di programmazione coerente sia sul lato client che sul lato server per i servizi Web moderni su HTTP.
Lo System.Net.Http spazio dei nomi e lo spazio dei nomi correlato System.Net.Http.Headers forniscono il set di componenti seguente:
- HttpClient - Classe primaria usata per inviare e ricevere richieste tramite HTTP.
- HttpRequestMessage e HttpResponseMessage - Messaggi HTTP definiti in RFC 2616 da IETF.
- HttpHeaders - Intestazioni HTTP definite in RFC 2616 da IETF.
- HttpClientHandler - Gestori HTTP responsabili della produzione di messaggi di risposta HTTP.
Sono disponibili vari gestori di messaggi HTTP che è possibile usare:
- DelegatingHandler - Classe usata per collegare un gestore in una catena di gestori.
- HttpMessageHandler - Classe semplice da cui derivare che supporta i requisiti più comuni per la maggior parte delle applicazioni.
- HttpClientHandler - Classe che opera nella parte inferiore della catena di gestori che gestisce effettivamente le operazioni di trasporto HTTP.
Il contenuto di un messaggio HTTP corrisponde al corpo dell'entità definito in RFC 2616.
Per il contenuto HTTP è possibile usare le classi seguenti:
- ByteArrayContent - Contenuto HTTP basato su una matrice di byte.
- FormUrlEncodedContent - Contenuto HTTP delle tuple nome/valore codificate con il tipo MIME application/x-www-form-urlencoded.
- MultipartContent - Contenuto HTTP serializzato usando la specifica del tipo di contenuto multipart/* .
- MultipartFormDataContent - Contenuto HTTP codificato con il tipo MIME multipart/form-data.
- StreamContent - Contenuto HTTP basato su un flusso.
- StringContent - Contenuto HTTP basato su una stringa.
Se l'app usa gli System.Net.Http spazi dei nomi e System.Net.Http.Headers e intende scaricare grandi quantità di dati (50 megabyte o più), deve trasmettere tali download e non usare il buffer predefinito. Se si usa il buffering predefinito, l'utilizzo della memoria client avrà dimensioni molto elevate, con conseguente riduzione sostanziale delle prestazioni.