System.Net.Http Naamruimte

Biedt een programmeerinterface voor moderne HTTP-toepassingen.

Klassen

Name Description
ByteArrayContent

Biedt HTTP-inhoud op basis van een bytematrix.

DelegatingHandler

Een type voor HTTP-handlers die de verwerking van HTTP-antwoordberichten delegeren aan een andere handler, de binnenhandler genoemd.

FormUrlEncodedContent

Een container voor naam/waarde-tuples die zijn gecodeerd met behulp van het MIME-type application/x-www-form-urlencoded.

HttpClient

Biedt een klasse voor het verzenden van HTTP-aanvragen en het ontvangen van HTTP-antwoorden van een resource die is geïdentificeerd door een URI.

HttpClientFactoryExtensions

Uitbreidingsmethoden voor IHttpClientFactory.

HttpClientHandler

De standaardberichthandler die wordt gebruikt door HttpClient in .NET Framework.

HttpContent

Een basisklasse die de hoofdtekst en inhoudsheaders van een HTTP-entiteit vertegenwoordigt.

HttpDiagnosticsHttpRequestMessageExtensions

Extensies voor hulpprogramma's voor telemetrie.

HttpIOException

De uitzondering die wordt gegenereerd wanneer er een fout optreedt tijdens het lezen van het antwoord.

HttpMessageHandler

Een basistype voor HTTP-berichthandlers.

HttpMessageHandlerFactoryExtensions

Uitbreidingsmethoden voor IHttpMessageHandlerFactory.

HttpMessageInvoker

Een speciale klasse waarmee toepassingen de SendAsync(HttpRequestMessage, CancellationToken) methode kunnen aanroepen in een HTTP-handlerketen.

HttpMethod

Een helperklasse voor het ophalen en vergelijken van standaard HTTP-methoden en voor het maken van nieuwe HTTP-methoden.

HttpProtocolException

De uitzondering die optreedt wanneer er een HTTP/2- of HTTP/3-protocolfout optreedt.

HttpRequestException

Een basisklasse voor uitzonderingen die worden gegenereerd door de HttpClient en HttpMessageHandler klassen.

HttpRequestMessage

Vertegenwoordigt een HTTP-aanvraagbericht.

HttpRequestOptions

Vertegenwoordigt een verzameling opties voor een HTTP-aanvraag.

HttpResilienceHttpRequestMessageExtensions

De tolerantie-extensies voor HttpRequestMessage.

HttpResponseMessage

Vertegenwoordigt een HTTP-antwoordbericht, inclusief de statuscode en gegevens.

MessageProcessingHandler

Een basistype voor handlers die slechts een kleine verwerking van aanvraag- en/of antwoordberichten uitvoeren.

MultipartContent

Biedt een verzameling objecten die worden geserialiseerd met behulp van HttpContent de specificatie voor meerdere onderdelen/* inhoudstypen.

MultipartFormDataContent

Biedt een container voor inhoud die is gecodeerd met behulp van mime-type met meerdere onderdelen/formuliergegevens.

ReadOnlyMemoryContent

Biedt HTTP-inhoud op basis van een ReadOnlyMemory<T>.

RtcRequestFactory

Biedt een programmeerinterface voor moderne HTTP-toepassingen.

SocketsHttpConnectionContext

Vertegenwoordigt de context die wordt doorgegeven aan de ConnectCallback instantie.SocketsHttpHandler .

SocketsHttpHandler

Biedt de standaardberichthandler die wordt gebruikt door HttpClient.

SocketsHttpPlaintextStreamFilterContext

Vertegenwoordigt de context die wordt doorgegeven aan het PlaintextStreamFilter voor een SocketsHttpHandler-exemplaar.

StreamContent

Biedt HTTP-inhoud op basis van een stream.

StringContent

Biedt HTTP-inhoud op basis van een tekenreeks.

WebRequestHandler

Biedt bureaubladspecifieke functies die niet beschikbaar zijn voor Windows Store-apps of andere omgevingen.

WinHttpHandler

Hiermee worden berichten verwerkt op basis van de WinHTTP-interface van Windows. Deze klasse is bedoeld voor gebruik in serveromgevingen.

Structs

Name Description
HttpRequestOptionsKey<TValue>

Vertegenwoordigt een sleutel in de optiesverzameling voor een HTTP-aanvraag.

Interfaces

Name Description
IHttpClientFactory

Een factoryabstractie voor een onderdeel dat exemplaren met aangepaste configuratie voor een bepaalde logische naam kan maken HttpClient .

IHttpMessageHandlerFactory

Een factoryabstractie voor een onderdeel dat exemplaren met aangepaste configuratie voor een bepaalde logische naam kan maken HttpMessageHandler .

Enums

Name Description
ClientCertificateOption

Hiermee geeft u op hoe clientcertificaten worden opgegeven.

CookieUsePolicy

Met deze inventarisatie kan het beheer van HTTP-cookies tijdens de communicatie met de server worden toegestaan.

HttpCompletionOption

Geeft aan of HttpClient bewerkingen moeten worden beschouwd als voltooid zodra een antwoord beschikbaar is, of nadat het volledige antwoordbericht met inbegrip van de inhoud is gelezen.

HttpKeepAlivePingPolicy

Hiermee geeft u op wanneer het HTTP/2-pingframe wordt verzonden op een niet-actieve verbinding.

HttpRequestError

Definieert foutcategorieën die de reden voor HttpRequestException of HttpIOException.

HttpVersionPolicy

Hiermee geeft u gedrag op voor het selecteren en onderhandelen van de HTTP-versie voor een aanvraag.

WindowsProxyUsePolicy

Deze opsomming biedt beschikbare opties voor de proxy-instellingen die worden gebruikt door een HttpClient bij uitvoering op Windows.

Gedelegeerden

Name Description
HeaderEncodingSelector<TContext>

Vertegenwoordigt een methode die de codering aangeeft die moet worden gebruikt bij het interpreteren van headerwaarden.

Opmerkingen

De System.Net.Http naamruimte is ontworpen om de volgende onderdelen te bieden:

  • HTTP-clientonderdelen waarmee gebruikers moderne webservices via HTTP kunnen gebruiken.
  • HTTP-onderdelen die kunnen worden gebruikt door clients en servers (bijvoorbeeld HTTP-headers en berichten). Dit biedt een consistent programmeermodel op zowel de client als de serverzijde voor moderne webservices via HTTP.

De System.Net.Http naamruimte en de gerelateerde System.Net.Http.Headers naamruimte bevatten de volgende set onderdelen:

  • HttpClient - De primaire klasse die wordt gebruikt voor het verzenden en ontvangen van aanvragen via HTTP.
  • HttpRequestMessage en HttpResponseMessage - HTTP-berichten zoals gedefinieerd in RFC 2616 door de IETF.
  • HttpHeaders - HTTP-headers zoals gedefinieerd in RFC 2616 door de IETF.
  • HttpClientHandler - HTTP-handlers die verantwoordelijk zijn voor het produceren van HTTP-antwoordberichten.

Er zijn verschillende HTTP-berichthandlers die u kunt gebruiken:

  • DelegatingHandler - Een klasse die wordt gebruikt om een handler aan te sluiten in een handlerketen.
  • HttpMessageHandler - Een eenvoudige klasse die moet worden afgeleid van die ondersteuning biedt voor de meest voorkomende vereisten voor de meeste toepassingen.
  • HttpClientHandler - Een klasse die onder aan de handlerketen werkt die daadwerkelijk de HTTP-transportbewerkingen afhandelt.

De inhoud van een HTTP-bericht komt overeen met de entiteitsbody die is gedefinieerd in RFC 2616.

De volgende klassen kunnen worden gebruikt voor HTTP-inhoud:

  • ByteArrayContent - HTTP-inhoud op basis van een bytematrix.
  • FormUrlEncodedContent - HTTP-inhoud van naam/waarde tuples gecodeerd met application/x-www-form-urlencoded MIME-type.
  • MultipartContent - HTTP-inhoud die wordt geserialiseerd met behulp van de specificatie voor meerdere onderdelen/* inhoudstypen.
  • MultipartFormDataContent - HTTP-inhoud gecodeerd met behulp van het MIME-type multipart/form-data.
  • StreamContent - HTTP-inhoud op basis van een stream.
  • StringContent - HTTP-inhoud op basis van een tekenreeks.

Als uw app gebruikmaakt van de System.Net.Http en System.Net.Http.Headers naamruimten en van plan is grote hoeveelheden gegevens (50 megabytes of meer) te downloaden, moeten deze downloads worden gestreamd en niet de standaardbuffering worden gebruikt. Als u de standaardbuffering gebruikt, wordt het geheugengebruik van de client erg groot, waardoor de prestaties aanzienlijk kunnen verminderen.

Zie ook