System.Net.Http Obor názvů

Poskytuje programovací rozhraní pro moderní aplikace HTTP.

Třídy

Name	Description
ByteArrayContent	Poskytuje obsah HTTP založený na bajtovém poli.
DelegatingHandler	Typ obslužných rutin HTTP, které deleguje zpracování zpráv odpovědi HTTP na jinou obslužnou rutinu, která se nazývá vnitřní obslužná rutina.
FormUrlEncodedContent	Kontejner pro řazené kolekce členů názvů a hodnot 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á HttpClient v 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á se vyvolá, 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é 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.
HttpProtocolException	Výjimka vyvolaná v případě, že dojde k chybě protokolu HTTP/2 nebo HTTP/3.
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í datového typu MIME s více částmi nebo formulářem.
ReadOnlyMemoryContent	Poskytuje obsah HTTP založený na .ReadOnlyMemory<T>
SocketsHttpConnectionContext	Představuje kontext předaný ConnectCallback instanci pro SocketsHttpHandler instanci. .
SocketsHttpHandler	Poskytuje výchozí obslužnou HttpClient rutinu zpráv používanou 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.

Struktury

Name	Description
HttpRequestOptionsKey<TValue>	Představuje klíč v kolekci možností pro požadavek HTTP.

Výčty

Name	Description
ClientCertificateOption	Určuje způsob poskytnutí klientských certifikátů.
HttpCompletionOption	Označuje, jestli se operace HttpClient 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 v nečinné připojení odešle rámec ping HTTP/2.
HttpRequestError	Definuje kategorie chyb představující důvod HttpRequestException nebo HttpIOException.
HttpVersionPolicy	Určuje chování pro výběr a vyjednávání verze HTTP pro požadavek.

Delegáti

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

Poznámky

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

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

Obor System.Net.Http názvů a související System.Net.Http.Headers obor názvů poskytují následující sadu komponent:

• HttpClient – Primární třída používaná k odesílání a přijímání požadavků přes protokol HTTP.
• HttpRequestMessage a HttpResponseMessage - HTTP zprávy definované v RFC 2616 IETF.
• HttpHeaders – Hlavičky HTTP definované v DOKUMENTU RFC 2616 podle IETF.
• 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é můžete použít:

• DelegatingHandler – Třída použitá k připojení obslužné rutiny do řetězu obslužných rutin.
• HttpMessageHandler - Jednoduchá třída, která je odvozena z toho, která podporuje nejběžnější požadavky pro většinu aplikací.
• HttpClientHandler – Třída, která pracuje v dolní části řetězu obslužných rutin, která ve skutečnosti zpracovává přenosové operace HTTP.

Obsah zprávy HTTP odpovídá textu entity definovanému v dokumentu RFC 2616.

Pro obsah HTTP lze použít následující třídy:

• ByteArrayContent – Obsah HTTP založený na bajtovém poli.
• FormUrlEncodedContent – Obsah řazených kolekcí členů názvu/hodnoty HTTP kódovaný pomocí typu MIME application/x-www-form-urlencoded.
• MultipartContent – Obsah HTTP, který se serializuje pomocí specifikace typu obsahu s více částmi/*.
• MultipartFormDataContent – Obsah HTTP kódovaný pomocí vícedílového nebo form-datového typu MIME.
• StreamContent – Obsah HTTP založený na datovém proudu.
• StringContent – Obsah HTTP založený na řetězci.

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

Viz také

• System.Net.Http.Headers