System.Net.Http Namnområde
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Tillhandahåller ett programmeringsgränssnitt för moderna HTTP-program.
Klasser
| Name | Description |
|---|---|
| ByteArrayContent |
Tillhandahåller HTTP-innehåll baserat på en bytematris. |
| DelegatingHandler |
En typ för HTTP-hanterare som delegerar bearbetningen av HTTP-svarsmeddelanden till en annan hanterare, kallad den inre hanteraren. |
| FormUrlEncodedContent |
En container för namn/värde tupplar kodade med hjälp av application/x-www-form-urlencoded MIME-typ. |
| HttpClient |
Tillhandahåller en klass för att skicka HTTP-begäranden och ta emot HTTP-svar från en resurs som identifieras av en URI. |
| HttpClientFactoryExtensions |
Tilläggsmetoder för IHttpClientFactory. |
| HttpClientHandler |
Standardmeddelandehanteraren som används av HttpClient i .NET Framework. |
| HttpContent |
En basklass som representerar en HTTP-entitetstext och innehållshuvuden. |
| HttpDiagnosticsHttpRequestMessageExtensions |
Tillägg för telemetriverktyg. |
| HttpIOException |
Undantaget som utlöses när ett fel inträffar när svaret läses. |
| HttpMessageHandler |
En bastyp för HTTP-meddelandehanterare. |
| HttpMessageHandlerFactoryExtensions |
Tilläggsmetoder för IHttpMessageHandlerFactory. |
| HttpMessageInvoker |
En specialklass som gör att program kan anropa metoden i SendAsync(HttpRequestMessage, CancellationToken) en HTTP-hanteringskedja. |
| HttpMethod |
En hjälpklass för att hämta och jämföra HTTP-standardmetoder och för att skapa nya HTTP-metoder. |
| HttpProtocolException |
Undantaget utlöses när ett HTTP/2- eller HTTP/3-protokollfel inträffar. |
| HttpRequestException |
En basklass för undantag som genereras av HttpClient klasserna och HttpMessageHandler . |
| HttpRequestMessage |
Representerar ett HTTP-begärandemeddelande. |
| HttpRequestOptions |
Representerar en samling alternativ för en HTTP-begäran. |
| HttpResilienceHttpRequestMessageExtensions |
Motståndskraftstilläggen för HttpRequestMessage. |
| HttpResponseMessage |
Representerar ett HTTP-svarsmeddelande med statuskoden och data. |
| MessageProcessingHandler |
En bastyp för hanterare som bara utför viss liten bearbetning av begärande- och/eller svarsmeddelanden. |
| MultipartContent |
Tillhandahåller en samling objekt som serialiseras med hjälp av HttpContent innehållstypspecifikationen för flera delar/* . |
| MultipartFormDataContent |
Tillhandahåller en container för innehåll som kodas med mime-typen multipart/form-data. |
| ReadOnlyMemoryContent |
Tillhandahåller HTTP-innehåll baserat på en ReadOnlyMemory<T>. |
| RtcRequestFactory |
Tillhandahåller ett programmeringsgränssnitt för moderna HTTP-program. |
| SocketsHttpConnectionContext |
Representerar kontexten som skickas ConnectCallback till för en SocketsHttpHandler instans. . |
| SocketsHttpHandler |
Tillhandahåller standardmeddelandehanteraren som används av HttpClient. |
| SocketsHttpPlaintextStreamFilterContext |
Representerar kontexten som skickas till PlaintextStreamFilter för en SocketsHttpHandler-instans. |
| StreamContent |
Tillhandahåller HTTP-innehåll baserat på en dataström. |
| StringContent |
Tillhandahåller HTTP-innehåll baserat på en sträng. |
| WebRequestHandler |
Tillhandahåller skrivbordsspecifika funktioner som inte är tillgängliga för Windows Store-appar eller andra miljöer. |
| WinHttpHandler |
Hanterar meddelanden baserat på WinHTTP-gränssnittet för Windows. Den här klassen är avsedd för användning i servermiljöer. |
Strukturer
| Name | Description |
|---|---|
| HttpRequestOptionsKey<TValue> |
Representerar en nyckel i alternativsamlingen för en HTTP-begäran. |
Gränssnitt
| Name | Description |
|---|---|
| IHttpClientFactory |
En fabriksabstraktion för en komponent som kan skapa HttpClient instanser med anpassad konfiguration för ett visst logiskt namn. |
| IHttpMessageHandlerFactory |
En fabriksabstraktion för en komponent som kan skapa HttpMessageHandler instanser med anpassad konfiguration för ett visst logiskt namn. |
Uppräkningar
| Name | Description |
|---|---|
| ClientCertificateOption |
Anger hur klientcertifikat tillhandahålls. |
| CookieUsePolicy |
Den här uppräkningen ger kontroll över HTTP-cookies när du kommunicerar med servern. |
| HttpCompletionOption |
Anger om HttpClient åtgärder ska anses slutförda antingen så snart ett svar är tillgängligt eller efter att du har läst hela svarsmeddelandet inklusive innehållet. |
| HttpKeepAlivePingPolicy |
Anger när HTTP/2-pingramen skickas på en inaktiv anslutning. |
| HttpRequestError |
Definierar felkategorier som representerar orsaken till HttpRequestException eller HttpIOException. |
| HttpVersionPolicy |
Anger beteenden för att välja och förhandla om HTTP-versionen för en begäran. |
| WindowsProxyUsePolicy |
Den här uppräkningen innehåller tillgängliga alternativ för proxyinställningarna som används av en HttpClient när den körs på Windows. |
Delegeringar
| Name | Description |
|---|---|
| HeaderEncodingSelector<TContext> |
Representerar en metod som anger vilken kodning som ska användas vid tolkning av rubrikvärden. |
Kommentarer
Namnområdet System.Net.Http är utformat för att tillhandahålla följande komponenter:
- HTTP-klientkomponenter som gör det möjligt för användare att använda moderna webbtjänster via HTTP.
- HTTP-komponenter som kan användas av både klienter och servrar (till exempel HTTP-huvuden och meddelanden). Detta ger en konsekvent programmeringsmodell på både klient- och serversidan för moderna webbtjänster via HTTP.
Namnområdet System.Net.Http och det relaterade System.Net.Http.Headers namnområdet innehåller följande uppsättning komponenter:
- HttpClient – Den primära klassen som används för att skicka och ta emot begäranden via HTTP.
- HttpRequestMessage och HttpResponseMessage – HTTP-meddelanden enligt definitionen i RFC 2616 av IETF.
- HttpHeaders – HTTP-huvuden enligt definitionen i RFC 2616 av IETF.
- HttpClientHandler – HTTP-hanterare som ansvarar för att skapa HTTP-svarsmeddelanden.
Det finns olika HTTP-meddelandehanterare som du kan använda:
- DelegatingHandler – En klass som används för att ansluta en hanterare till en hanterarkedja.
- HttpMessageHandler – En enkel klass att härleda från som stöder de vanligaste kraven för de flesta program.
- HttpClientHandler – En klass som fungerar längst ned i hanteringskedjan som faktiskt hanterar HTTP-transportåtgärderna.
Innehållet i ett HTTP-meddelande motsvarar entitetstexten som definierats i RFC 2616.
Följande klasser kan användas för HTTP-innehåll:
- ByteArrayContent – HTTP-innehåll baserat på en bytematris.
- FormUrlEncodedContent – HTTP-innehåll med namn/värde tupplar kodade med hjälp av program/x-www-form-urlencoded MIME-typ.
- MultipartContent – HTTP-innehåll som serialiseras med hjälp av innehållstypspecifikationen för flera delar/*.
- MultipartFormDataContent – HTTP-innehåll som kodas med mime-typen multipart/form-data.
- StreamContent – HTTP-innehåll baserat på en dataström.
- StringContent – HTTP-innehåll baserat på en sträng.
Om din app använder System.Net.Http namnrymderna och System.Net.Http.Headers avser att ladda ned stora mängder data (50 mb eller mer) bör den strömma dessa nedladdningar och inte använda standardbuffertningen. Om du använder standardbuffertningen blir klientminnesanvändningen mycket stor, vilket kan leda till avsevärt lägre prestanda.
