System.Net.Http Naamruimte
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
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.