System.Net.Http Obor názvů

Reference

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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.
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ších verzích.
HttpContent	Základní třída představující tělo entity HTTP a hlavičky obsahu.
HttpDiagnosticsHttpRequestMessageExtensions	Rozšíření pro telemetrické nástroje
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.
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ý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.
HttpResilienceHttpRequestMessageExtensions	Rozšíření odolnosti pro HttpRequestMessage.
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>.
RtcRequestFactory	Poskytuje programovací rozhraní pro moderní aplikace HTTP.
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.
WebRequestHandler	Poskytuje funkce specifické pro stolní počítače, které nejsou dostupné v aplikacích pro Windows Store ani v jiných prostředích.
WinHttpHandler	Zpracovává zprávy na základě rozhraní WinHTTP systému Windows. Tato třída je určená 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 kontrolu souborů HTTP cookie při komunikaci se serverem.
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 HttpRequestException HttpIOException.
HttpVersionPolicy	Určuje chování pro výběr a vyjednávání verze HTTP požadavku.
WindowsProxyUsePolicy	Tento výčet poskytuje dostupné možnosti pro nastavení proxy serveru, které používá při HttpClient spuštění ve Windows.

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í:

Komponenty klienta PROTOKOLU HTTP, které uživatelům umožňují využívat moderní webové služby přes protokol HTTP.
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í:

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 – zprávy HTTP definované v DOKUMENTU RFC 2616 podle IETF.
HttpHeaders – Hlavičky HTTP definované v DOKUMENTU RFC 2616 pomocí 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é je možné použít. Patří mezi ně následující:

DelegatingHandler – Třída používaná k připojení obslužné rutiny do řetězce obslužné rutiny.
HttpMessageHandler – Jednoduchá třída, ze které lze odvodit, která podporuje nejběžnější požadavky pro většinu aplikací.
HttpClientHandler – Třída, která pracuje v dolní části řetězce obslužné rutiny, který ve skutečnosti zpracovává operace přenosu HTTP.
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í:

ByteArrayContent – Obsah HTTP založený na bajtovém poli.
FormUrlEncodedContent – Obsah HTTP řazených kolekcí členů název/hodnota kódovaný pomocí typu MIME application/x-www-form-urlencoded.
MultipartContent – Obsah HTTP, který se serializuje pomocí specifikace typu obsahu multipart/*.
MultipartFormDataContent – Obsah HTTP kódovaný pomocí typu MIME multipart/form-data.
StreamContent – Obsah HTTP založený na streamu.
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.

Sdílet prostřednictvím