System.Net.Http Obor názvů

Poskytuje programovací rozhraní pro moderní aplikace HTTP.

Třídy

ByteArrayContent	Poskytuje obsah HTTP založený na bajtovém poli.
CFNetworkHandler
DelegatingHandler	Typ pro obslužné rutiny HTTP, které deleguje zpracování zpráv odpovědí HTTP na jinou obslužnou rutinu, která se nazývá vnitřní obslužná rutina.
FormUrlEncodedContent	Kontejner pro názvy a hodnoty řazených kolekcí členů pomocí typu APPLICATION/x-www-form-urlencoded MIME.
HttpClient	Poskytuje třídu pro odesílání požadavků HTTP a příjem odpovědí HTTP z prostředku identifikovaného identifikátorem URI.
HttpClientFactoryExtensions	Metody rozšíření pro IHttpClientFactory.
HttpClientHandler	Výchozí obslužná rutina zpráv používaná v HttpClient rozhraní .NET Framework a .NET Core 2.0 a starší.
HttpContent	Základní třída představující tělo entity HTTP a hlavičky obsahu.
HttpMessageHandler	Základní typ obslužných rutin zpráv HTTP
HttpMessageHandlerFactoryExtensions	Metody rozšíření pro IHttpMessageHandlerFactory.
HttpMessageInvoker	Speciální třída, která umožňuje aplikacím volat metodu SendAsync(HttpRequestMessage, CancellationToken) v řetězu obslužné rutiny HTTP.
HttpMethod	Pomocná třída pro načítání a porovnávání standardních metod HTTP a pro vytváření nových metod HTTP.
HttpRequestException	Základní třída pro výjimky vyvolané třídami HttpClient a HttpMessageHandler třídami.
HttpRequestMessage	Představuje zprávu požadavku HTTP.
HttpRequestOptions	Představuje kolekci možností pro požadavek HTTP.
HttpResponseMessage	Představuje zprávu odpovědi HTTP včetně stavového kódu a dat.
MessageProcessingHandler	Základní typ pro obslužné rutiny, které zpracovávají pouze malé zpracování zpráv požadavků nebo odpovědí.
MultipartContent	Poskytuje kolekci HttpContent objektů, které se serializují pomocí specifikace typu obsahu s více částmi/*.
MultipartFormDataContent	Poskytuje kontejner pro obsah kódovaný pomocí typu MIME s více částmi nebo form-data.
NSUrlSessionHandler	Výchozí obslužná rutina zprávy používaná  HttpClient   na platformách Apple pomocí sady Xamarin Stack (iOS, MacOS, WatchOS, tvOS)
ReadOnlyMemoryContent	Poskytuje obsah HTTP založený na ReadOnlyMemory<T>.
RtcRequestFactory
SocketsHttpConnectionContext	Představuje kontext předaný ConnectCallback instanci.SocketsHttpHandler .
SocketsHttpHandler	Poskytuje výchozí obslužnou rutinu zpráv používanou HttpClient v .NET Core 2.1 a novějším.
SocketsHttpPlaintextStreamFilterContext	Představuje kontext předaný plaintextStreamFilter pro instanci SocketsHttpHandler.
StreamContent	Poskytuje obsah HTTP založený na datovém proudu.
StringContent	Poskytuje obsah HTTP založený na řetězci.
WebRequestHandler	poskytuje funkce specifické pro plochu, které nejsou k dispozici pro Windows aplikací pro store nebo jiných prostředí.
WinHttpHandler	Zpracovává zprávy na základě rozhraní WinHTTP Windows. Tato třída je určena pro použití v serverových prostředích.

Struktury

HttpRequestOptionsKey<TValue>

Představuje klíč v kolekci možností pro požadavek HTTP.

Rozhraní

IHttpClientFactory	Abstrakce továrny pro komponentu, která může vytvářet HttpClient instance s vlastní konfigurací pro daný logický název.
IHttpMessageHandlerFactory	Abstrakce továrny pro komponentu, která může vytvářet HttpMessageHandler instance s vlastní konfigurací pro daný logický název.

Výčty

ClientCertificateOption	Určuje, jak se poskytují klientské certifikáty.
CookieUsePolicy	Tento výčet umožňuje řídit soubory cookie HTTP při komunikaci se serverem.
HttpCompletionOption	Označuje, jestli HttpClient se operace mají považovat za dokončené, jakmile bude odpověď k dispozici, nebo po přečtení celé zprávy odpovědi včetně obsahu.
HttpKeepAlivePingPolicy	Určuje, kdy se na nečinné připojení odešle rámec ping HTTP/2.
HttpVersionPolicy	Určuje chování pro výběr a vyjednávání verze HTTP pro požadavek.
WindowsProxyUsePolicy	Tento výčet poskytuje dostupné možnosti nastavení proxy serveru používaného HttpClient při spuštění na Windows.

Delegáti

HeaderEncodingSelector<TContext>

Představuje metodu, která určuje kódování, které se má použít při interpretaci hodnot záhlaví.

Poznámky

System.Net.HttpObor názvů je navržený tak, aby poskytoval následující:

1. Komponenty klienta HTTP, které umožňují uživatelům využívat moderní webové služby prostřednictvím protokolu HTTP.

2. Komponenty HTTP, které mohou být používány klienty i servery (například hlavičky a zprávy protokolu HTTP). To poskytuje jednotný programovací model na straně klienta i na straně serveru pro moderní webové služby prostřednictvím protokolu HTTP.

System.Net.HttpObor názvů a související System.Net.Http.Headers obor názvů poskytují následující sadu součástí:

1. HttpClient – primární Třída použitá pro posílání a přijímání požadavků přes HTTP.

2. HttpRequestMessage a HttpResponseMessage -http zprávy definované v dokumentu RFC 2616 skupinou IETF.

3. HttpHeaders – Hlavičky protokolu HTTP definované v dokumentu RFC 2616 sdružení IETF.

4. HttpClientHandler – Obslužné rutiny HTTP zodpovědné za vytváření zpráv s odpověďmi HTTP.

Existují různé obslužné rutiny zpráv HTTP, které je možné použít. Mezi ně patří následující:

1. DelegatingHandler – Třída použitá pro připojení obslužné rutiny do řetězce obslužné rutiny.

2. HttpMessageHandler – Jednoduchá třída odvozená od, která podporuje nejběžnější požadavky pro většinu aplikací.

3. HttpClientHandler – Třída, která pracuje na konci řetězce obslužné rutiny, který ve skutečnosti zpracovává operace přenosu HTTP.

4. WebRequestHandler – Speciální třída, která pracuje na konci třídy řetězu obslužné rutiny, která zpracovává operace přenosu HTTP s možnostmi, které jsou specifické pro System.Net.HttpWebRequest objekt.

Obsah zprávy HTTP odpovídá tělo entity definované v dokumentu RFC 2616.

Pro obsah HTTP lze použít řadu tříd. Mezi ně patří následující:

1. ByteArrayContent – Obsah HTTP založený na poli bajtů.

2. FormUrlEncodedContent – Obsah HTTP řazených kolekcí členů s názvem a hodnotou zakódovaný pomocí aplikace/x-www-form-urlencoded typu MIME.

3. MultipartContent – Obsah HTTP, který se bude serializovat pomocí specifikace typu obsahu multipart/*.

4. MultipartFormDataContent -Obsah HTTP kódovaný pomocí typu MIME s více částmi/datovými formuláři.

5. StreamContent – Obsah HTTP založený na datovém proudu.

6. StringContent – Obsah HTTP založený na řetězci.

Pokud aplikace, která používá System.Net.Http System.Net.Http.Headers obory názvů a, zamýšlí stahovat velké objemy dat (50 megabajtů nebo více), aplikace by měla tyto soubory ke stažení zasílat a nepoužívat výchozí vyrovnávací paměť. Pokud se používá výchozí ukládání do vyrovnávací paměti, využití paměti klienta bude velmi velké, může to mít za následek podstatně nižší výkon.

Třídy v System.Net.Http System.Net.Http.Headers oborech názvů a se dají použít k vývoji aplikací pro Windows Store nebo aplikací klasické pracovní plochy. Při použití v aplikaci pro Windows Store jsou třídy v System.Net.Http System.Net.Http.Headers oborech názvů a ovlivněny funkcí izolace sítě, které jsou součástí modelu zabezpečení aplikace používaného v systému Windows 8. V manifestu aplikace musí být povoleny vhodné síťové funkce pro aplikaci pro Windows Store, aby mohl systém povolit přístup k síti z aplikace pro Windows Store. Další informace najdete v tématu izolace sítě pro aplikace pro Windows Store.

Viz také

• System.Net.Http.Headers
• Připojení k webové službě
• Ukázka HttpClient