System.Net.Http Namespace

Stellt eine Programmierschnittstelle für moderne HTTP-Anwendungen zur Verfügung.

Klassen

ByteArrayContent

Stellt HTTP-Inhalt auf Grundlage von einem Bytearray bereit.

DelegatingHandler

Ein Typ für HTTP-Handler, die die Verarbeitung von HTTP-Antwortnachrichten in einen anderen Handler (den internen Handler) delegieren.

FormUrlEncodedContent

Ein Container für die Name/Wert-Tupel, codiert mit dem "application/x-www-form-urlencoded" MIME-Typ.

HttpClient

Stellt eine Klasse zum Senden von HTTP-Anforderungen und zum Empfangen von HTTP-Antworten von einer Ressource bereit, die durch einen URI identifiziert wird.

HttpClientFactoryExtensions

Erweiterungsmethoden für IHttpClientFactory.

HttpClientHandler

Den Standardnachrichtenhandler, der von HttpClient in .NET Framework und .NET Core 2.0 und früheren Versionen verwendet wird.

HttpContent

Eine Basisklasse, die einen HTTP-Entitätstext und Inhaltsheader darstellt.

HttpDiagnosticsHttpRequestMessageExtensions

Erweiterungen für Telemetrieprogramme.

HttpIOException

Die Ausnahme, die ausgelöst wird, wenn beim Lesen der Antwort ein Fehler auftritt.

HttpMessageHandler

Ein Basistyp für HTTP-Meldungshandler.

HttpMessageHandlerFactoryExtensions

Erweiterungsmethoden für IHttpMessageHandlerFactory.

HttpMessageInvoker

Eine spezielle Klasse, die es Anwendungen ermöglicht, die SendAsync(HttpRequestMessage, CancellationToken)-Methode auf einer HTTP-Handlerkette aufzurufen.

HttpMethod

Eine Hilfsprogrammklasse für das Abrufen und das Vergleichen von Standard-HTTP-Methoden und zum Erstellen von neuen HTTP-Methoden.

HttpProtocolException

Die Ausnahme, die ausgelöst wird, wenn ein HTTP/2- oder EIN HTTP/3-Protokollfehler auftritt.

HttpRequestException

Eine Basisklasse für Ausnahmen, die von den Klassen HttpClient und HttpMessageHandler ausgelöst werden.

HttpRequestMessage

Stellt eine HTTP-Anforderungsnachricht dar.

HttpRequestOptions

Stellt eine Auflistung von Optionen für eine HTTP-Anforderung dar.

HttpResilienceHttpRequestMessageExtensions

Die Resilienzerweiterungen für HttpRequestMessage.

HttpResponseMessage

Stellt eine HTTP-Antwortnachricht einschließlich den Statuscodes und der Daten dar.

MessageProcessingHandler

Ein Basistyp für Handler, die nur am Rande an der Verarbeitung von Anforderungs- und/oder Antwortnachrichten beteiligt sind.

MultipartContent

Stellt eine Auflistung von HttpContent-Objekten bereit, die mithilfe der multipart/*-Inhaltstypspezifikation serialisiert werden.

MultipartFormDataContent

Stellt einen Container für Inhalt bereit, der mithilfe des MIME-Typs „multipart/form-data“ codiert wurde.

ReadOnlyMemoryContent

Stellt HTTP-Inhalt auf der Grundlage von ReadOnlyMemory<T> bereit.

RtcRequestFactory

Stellt eine Programmierschnittstelle für moderne HTTP-Anwendungen zur Verfügung.

SocketsHttpConnectionContext

Stellt den Kontext dar, der an ConnectCallback für eine SocketsHttpHandler-Instanz übergeben wird. .

SocketsHttpHandler

Stellt den Standardnachrichtenhandler bereit, der von HttpClient in .NET Core 2.1 und höher verwendet wird.

SocketsHttpPlaintextStreamFilterContext

Stellt den Kontext dar, der an den PlaintextStreamFilter für eine SocketsHttpHandler-Instanz übergeben wird.

StreamContent

Stellt HTTP-Inhalt auf Grundlage eines Streams bereit.

StringContent

Stellt HTTP-Inhalt auf Grundlage einer Zeichenfolge bereit.

WebRequestHandler

Stellt desktop-spezifische Funktionen bereit, die für Windows Store-Apps oder andere Umgebungen nicht verfügbar sind.

WinHttpHandler

Verarbeitet Nachrichten basierend auf der WinHTTP-Schnittstelle von Windows. Diese Klasse ist für die Verwendung in Serverumgebungen vorgesehen.

Strukturen

HttpRequestOptionsKey<TValue>

Stellt einen Schlüssel in der Optionsauflistung für eine HTTP-Anforderung dar.

Schnittstellen

IHttpClientFactory

Eine Factoryabstraktion für eine Komponente, die HttpClient-Instanzen mit benutzerdefinierter Konfiguration für einen angegebenen logischen Namen erstellen kann.

IHttpMessageHandlerFactory

Eine Factoryabstraktion für eine Komponente, die HttpMessageHandler-Instanzen mit benutzerdefinierter Konfiguration für einen angegebenen logischen Namen erstellen kann.

Enumerationen

ClientCertificateOption

Gibt an, wie die Clientzertifikate bereitgestellt werden.

CookieUsePolicy

Diese Enumeration ermöglicht das Steuern von HTTP-Cookies bei der Kommunikation mit dem Server.

HttpCompletionOption

Gibt an, ob HttpClient-Vorgänge als abgeschlossen betrachtet werden, sobald eine Antwort verfügbar ist, oder nachdem die gesamte Antwortnachricht einschließlich Inhalt gelesen wurde.

HttpKeepAlivePingPolicy

Gibt an, wann der HTTP/2-Pingrahmen bei einer Verbindung im Leerlauf gesendet wird.

HttpRequestError

Definiert Fehlerkategorien, die den Grund für HttpRequestException oder HttpIOExceptiondarstellen.

HttpVersionPolicy

Gibt Verhalten zum Auswählen und Aushandeln der HTTP-Version für eine Anforderung an.

WindowsProxyUsePolicy

Diese Enumeration stellt verfügbare Optionen für die Proxyeinstellungen bereit, die von einem HttpClient-Objekt bei der Ausführung unter Windows verwendet werden.

Delegaten

HeaderEncodingSelector<TContext>

Stellt eine Methode dar, die die beim Interpretieren von Headerwerten zu verwendende Codierung angibt.

Hinweise

Der System.Net.Http Namespace ist so konzipiert, dass folgendes bereitgestellt wird:

  1. HTTP-Clientkomponenten, mit denen Benutzer moderne Webdienste über HTTP nutzen können.

  2. HTTP-Komponenten, die sowohl von Clients als auch von Servern verwendet werden können (z. B. HTTP-Header und -Nachrichten). Dies bietet ein konsistentes Programmiermodell auf Client- und Serverseite für moderne Webdienste über HTTP.

Der System.Net.Http Namespace und der zugehörige System.Net.Http.Headers Namespace stellen den folgenden Satz von Komponenten bereit:

  1. HttpClient : Die primäre Klasse, die zum Senden und Empfangen von Anforderungen über HTTP verwendet wird.

  2. HttpRequestMessage und HttpResponseMessage : HTTP-Nachrichten, wie in RFC 2616 von der IETF definiert.

  3. HttpHeaders – HTTP-Header, wie in RFC 2616 von der IETF definiert.

  4. HttpClientHandler – HTTP-Handler, die für die Erstellung von HTTP-Antwortnachrichten verantwortlich sind.

Es gibt verschiedene HTTP-Nachrichtenhandler, die verwendet werden können. Hierzu zählen folgende:

  1. DelegatingHandler – Eine Klasse, die verwendet wird, um einen Handler in eine Handlerkette zu stecken.

  2. HttpMessageHandler – Eine einfache Klasse, die von abgeleitet werden soll, die die gängigsten Anforderungen für die meisten Anwendungen unterstützt.

  3. HttpClientHandler - Eine Klasse, die unten in der Handlerkette ausgeführt wird, die die HTTP-Transportvorgänge tatsächlich verarbeitet.

  4. WebRequestHandler – Eine Spezialklasse, die unten in der Handlerkettenklasse ausgeführt wird, die HTTP-Transportvorgänge mit objektspezifischen System.Net.HttpWebRequest Optionen verarbeitet.

Der Inhalt einer HTTP-Nachricht entspricht dem in RFC 2616 definierten Entitätstext.

Eine Reihe von Klassen kann für HTTP-Inhalte verwendet werden. Hierzu zählen folgende:

  1. ByteArrayContent – HTTP-Inhalt basierend auf einem Bytearray.

  2. FormUrlEncodedContent – HTTP-Inhalt von Namens-/Werttupeln, die mit dem MIME-Typ application/x-www-form-urlencoded codiert wurden.

  3. MultipartContent – HTTP-Inhalt, der mithilfe der Mehrteiligen/*-Inhaltstypspezifikation serialisiert wird.

  4. MultipartFormDataContent – HTTP-Inhalt, der mit dem MIME-Typ multipart/form-data codiert ist.

  5. StreamContent – HTTP-Inhalt basierend auf einem Stream.

  6. StringContent – HTTP-Inhalt basierend auf einer Zeichenfolge.

Wenn eine App, die die System.Net.Http Namespaces und System.Net.Http.Headers verwendet, große Datenmengen (50 MB oder mehr) herunterladen möchte, sollte die App diese Downloads streamen und nicht die Standardpufferung verwenden. Wenn die Standardpufferung verwendet wird, wird die Arbeitsspeicherauslastung des Clients sehr groß, was möglicherweise zu einer erheblichen Leistungsminderung führt.

Klassen in den System.Net.Http Namespaces und System.Net.Http.Headers können zum Entwickeln von Windows Store-Apps oder Desktop-Apps verwendet werden. Bei Verwendung in einer Windows Store-App sind Klassen in den Namespaces und System.Net.Http.Headers von der System.Net.Http Netzwerkisolation betroffen, die Teil des Anwendungssicherheitsmodells ist, das vom Windows 8 verwendet wird. Die entsprechenden Netzwerkfunktionen müssen im App-Manifest für eine Windows Store-App aktiviert sein, damit das System den Netzwerkzugriff durch eine Windows Store-App ermöglicht. Weitere Informationen finden Sie unter Netzwerkisolation für Windows Store-Apps.

Weitere Informationen