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.

HttpClientHandler

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

HttpContent

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

HttpMessageHandler

Een basistype voor HTTP-berichthandlers.

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.

HttpRequestException

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

HttpRequestMessage

Vertegenwoordigt een HTTP-aanvraagbericht.

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.

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.

Enums

Name Description
ClientCertificateOption

Hiermee geeft u op hoe clientcertificaten worden opgegeven.

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.

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