Sdílet prostřednictvím


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.

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 HttpRequestExceptionHttpIOException.

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

  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é