System.Net.Http Obor názvů

Poskytuje programovací rozhraní pro moderní aplikace HTTP.

Třídy

ByteArrayContent	Poskytuje obsah HTTP na základě pole bajtů.
DelegatingHandler	Typ pro obslužné rutiny PROTOKOLU HTTP, které deleguje zpracování zpráv odpovědí HTTP na jinou obslužnou rutinu označovanou jako vnitřní obslužná rutina.
FormUrlEncodedContent	Kontejner pro řazené kolekce členů název/hodnota kódované pomocí typu MIME application/x-www-form-urlencoded.
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.
HttpClientHandler	Výchozí obslužná rutina zpráv používaná v HttpClient rozhraní .NET Framework a .NET Core 2.0 a starších verzích.
HttpContent	Základní třída představující tělo entity HTTP a hlavičky obsahu.
HttpIOException	Výjimka, která je vyvolán, když dojde k chybě při čtení odpovědi.
HttpMessageHandler	Základní typ pro obslužné rutiny zpráv HTTP.
HttpMessageInvoker	Speciální třída, která umožňuje aplikacím volat metodu SendAsync(HttpRequestMessage, CancellationToken) v řetězu obslužných rutin 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.
HttpProtocolException	Výjimka vyvolá, když dojde k chybě protokolu HTTP/2 nebo HTTP/3.
HttpRequestException	Základní třída pro výjimky vyvolané třídami HttpClient a HttpMessageHandler .
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 obsahující stavový kód a data.
MessageProcessingHandler	Základní typ pro obslužné rutiny, které provádí pouze malé zpracování požadavků a/nebo zpráv odpovědí.
MultipartContent	Poskytuje kolekci HttpContent objektů, které jsou serializovány pomocí specifikace vícedílného/* typu obsahu.
MultipartFormDataContent	Poskytuje kontejner pro obsah kódovaný pomocí typu MIME multipart/form-data.
ReadOnlyMemoryContent	Poskytuje obsah HTTP založený na objektu ReadOnlyMemory<T>.
SocketsHttpConnectionContext	Představuje kontext předaný instanci ConnectCallback pro SocketsHttpHandler instanci. .
SocketsHttpHandler	Poskytuje výchozí obslužnou rutinu zpráv, kterou HttpClient používá v .NET Core 2.1 a novějších verzích.
SocketsHttpPlaintextStreamFilterContext	Představuje kontext předaný PlaintextStreamFilter pro SocketsHttpHandler instance.
StreamContent	Poskytuje obsah HTTP založený na streamu.
StringContent	Poskytuje obsah HTTP založený na řetězci.

Struktury

HttpRequestOptionsKey<TValue>

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

Výčty

ClientCertificateOption	Určuje, jak se poskytují klientské certifikáty.
HttpCompletionOption	Určuje, jestli HttpClient se operace mají považovat za dokončené, jakmile je k dispozici odpověď, nebo po přečtení celé zprávy odpovědi včetně obsahu.
HttpKeepAlivePingPolicy	Určuje, kdy se při nečinném připojení odešle rámec http/2 ping.
HttpRequestError	Definuje kategorie chyb představující důvod nebo HttpRequestExceptionHttpIOException.
HttpVersionPolicy	Určuje chování pro výběr a vyjednávání verze HTTP požadavku.

Delegáti

HeaderEncodingSelector<TContext>

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

Poznámky

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

1. Komponenty klienta PROTOKOLU HTTP, které uživatelům umožňují využívat moderní webové služby přes protokol HTTP.

2. Komponenty PROTOKOLU HTTP, které můžou používat klienti i servery (například hlavičky a zprávy PROTOKOLU HTTP). To poskytuje konzistentní programovací model na straně klienta i serveru pro moderní webové služby přes PROTOKOL HTTP.

Obor System.Net.Http 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žívaná k odesílání a přijímání požadavků přes protokol HTTP.

2. HttpRequestMessage a HttpResponseMessage – zprávy HTTP definované v DOKUMENTU RFC 2616 podle IETF.

3. HttpHeaders – Hlavičky HTTP definované v DOKUMENTU RFC 2616 pomocí IETF.

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

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

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

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

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

4. WebRequestHandler – Speciální třída, která pracuje v dolní části třídy řetězu obslužných rutin, která zpracovává operace přenosu HTTP s možnostmi specifickými pro System.Net.HttpWebRequest daný objekt.

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

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

1. ByteArrayContent – Obsah HTTP založený na bajtovém poli.

2. FormUrlEncodedContent – Obsah HTTP řazených kolekcí členů název/hodnota kódovaný pomocí typu MIME application/x-www-form-urlencoded.

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

4. MultipartFormDataContent – Obsah HTTP kódovaný pomocí typu MIME multipart/form-data.

5. StreamContent – Obsah HTTP založený na streamu.

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

Pokud aplikace používající System.Net.Http obory názvů a System.Net.Http.Headers má v úmyslu stahovat velké objemy dat (50 megabajtů nebo více), měla by tato stahování streamovat a neměla by používat výchozí vyrovnávací paměť. Pokud se použije výchozí ukládání do vyrovnávací paměti, využití paměti klienta bude velmi velké, což může mít za následek podstatně nižší výkon.

Třídy v System.Net.Http oborech názvů a System.Net.Http.Headers se dají použít k vývoji aplikací pro Windows Store nebo desktopových aplikací. Při použití v aplikaci pro Windows Store jsou třídy v System.Net.Http oborech názvů a System.Net.Http.Headers ovlivněny funkcí izolace sítě, která je součástí modelu zabezpečení aplikace používaného Windows 8. Aby bylo možné povolit přístup k síti aplikací aplikací pro Windows Store, musí být v manifestu aplikace pro Windows Store povolené příslušné síťové funkce. 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ě
• HttpClient – ukázka