System.Net.Http Namespace
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Stellt eine Programmierschnittstelle für moderne HTTP-Anwendungen bereit.
Klassen
| Name | Beschreibung |
|---|---|
| ByteArrayContent |
Stellt HTTP-Inhalte basierend auf einem Bytearray bereit. |
| DelegatingHandler |
Ein Typ für HTTP-Handler, die die Verarbeitung von HTTP-Antwortnachrichten an einen anderen Handler delegieren, der als innerer Handler bezeichnet wird. |
| FormUrlEncodedContent |
Ein Container für Name/Wert-Tupel, die mit application/x-www-form-urlencoded MIME-Typ codiert werden. |
| HttpClient |
Stellt eine Klasse zum Senden von HTTP-Anforderungen und empfangen von HTTP-Antworten von einer Ressource bereit, die durch einen URI identifiziert wird. |
| HttpClientHandler |
Der standardnachrichtenhandler, der von HttpClient in .NET Framework verwendet wird. |
| HttpContent |
Eine Basisklasse, die einen HTTP-Entitätstext und Inhaltsheader darstellt. |
| HttpMessageHandler |
Ein Basistyp für HTTP-Nachrichtenhandler. |
| HttpMessageInvoker |
Eine Spezialklasse, mit der Anwendungen die SendAsync(HttpRequestMessage, CancellationToken) Methode in einer HTTP-Handlerkette aufrufen können. |
| HttpMethod |
Eine Hilfsklasse zum Abrufen und Vergleichen von Standard-HTTP-Methoden und zum Erstellen neuer HTTP-Methoden. |
| HttpRequestException |
Eine Basisklasse für Ausnahmen, die von den HttpClient Und-Klassen HttpMessageHandler ausgelöst werden. |
| HttpRequestMessage |
Stellt eine HTTP-Anforderungsnachricht dar. |
| HttpResponseMessage |
Stellt eine HTTP-Antwortnachricht einschließlich Statuscode und Daten dar. |
| MessageProcessingHandler |
Ein Basistyp für Handler, die nur eine kleine Verarbeitung von Anforderungs- und/oder Antwortnachrichten ausführen. |
| MultipartContent |
Stellt eine Auflistung von HttpContent Objekten bereit, die mithilfe der Multipart/*-Inhaltstypspezifikation serialisiert werden. |
| MultipartFormDataContent |
Stellt einen Container für Inhalte bereit, die mit mehrteiligem/formulardaten-MIME-Typ codiert werden. |
| ReadOnlyMemoryContent |
Stellt HTTP-Inhalte basierend auf einem ReadOnlyMemory<T>. |
| RtcRequestFactory |
Stellt eine Programmierschnittstelle für moderne HTTP-Anwendungen bereit. |
| StreamContent |
Stellt HTTP-Inhalte basierend auf einem Datenstrom bereit. |
| StringContent |
Stellt HTTP-Inhalte basierend auf einer Zeichenfolge bereit. |
| WebRequestHandler |
Stellt desktopspezifische Features bereit, die für Windows Store-Apps oder andere Umgebungen nicht verfügbar sind. |
Enumerationen
| Name | Beschreibung |
|---|---|
| ClientCertificateOption |
Gibt an, wie Clientzertifikate bereitgestellt werden. |
| HttpCompletionOption |
Gibt an, ob HttpClient Vorgänge entweder abgeschlossen werden sollen, sobald eine Antwort verfügbar ist, oder nach dem Lesen der gesamten Antwortnachricht einschließlich des Inhalts. |
Hinweise
Der System.Net.Http Namespace wurde entwickelt, um die folgenden Komponenten bereitzustellen:
- HTTP-Clientkomponenten, mit denen Benutzer moderne Webdienste über HTTP nutzen können.
- HTTP-Komponenten, die von Clients und Servern verwendet werden können (z. B. HTTP-Header und Nachrichten). Dies bietet ein konsistentes Programmiermodell sowohl auf dem Client als auch auf der Serverseite für moderne Webdienste über HTTP.
Der System.Net.Http Namespace und der zugehörige System.Net.Http.Headers Namespace stellen die folgenden Komponenten bereit:
- HttpClient – Die primäre Klasse, die zum Senden und Empfangen von Anforderungen über HTTP verwendet wird.
- HttpRequestMessage und HttpResponseMessage - HTTP-Nachrichten, wie in RFC 2616 von der IETF definiert.
- HttpHeaders - HTTP-Header, wie in RFC 2616 vom IETF definiert.
- HttpClientHandler - HTTP-Handler, die für die Erstellung von HTTP-Antwortnachrichten verantwortlich sind.
Es gibt verschiedene HTTP-Nachrichtenhandler, die Sie verwenden können:
- DelegatingHandler – Eine Klasse, die zum Anschließen eines Handlers in eine Handlerkette verwendet wird.
- HttpMessageHandler – Eine einfache Klasse, von der die häufigsten Anforderungen für die meisten Anwendungen unterstützt werden.
- HttpClientHandler – Eine Klasse, die am unteren Rand der Handlerkette ausgeführt wird, die die HTTP-Transportvorgänge tatsächlich verarbeitet.
Der Inhalt einer HTTP-Nachricht entspricht dem in RFC 2616 definierten Entitätstext.
Die folgenden Klassen können für HTTP-Inhalte verwendet werden:
- ByteArrayContent - HTTP-Inhalt basierend auf einem Bytearray.
- FormUrlEncodedContent - HTTP-Inhalt von Name/Wert-Tupeln, die mit application/x-www-form-urlencoded MIME-Typ codiert werden.
- MultipartContent – HTTP-Inhalte, die mithilfe der Spezifikation des mehrteiligen/* Inhaltstyps serialisiert werden.
- MultipartFormDataContent – HTTP-Inhalt, der mit dem MIME-Typ "multipart/form-data" codiert wurde.
- StreamContent – HTTP-Inhalt basierend auf einem Datenstrom.
- StringContent - HTTP-Inhalt basierend auf einer Zeichenfolge.
Wenn Ihre App die System.Net.Http Und-Namespaces System.Net.Http.Headers verwendet und große Datenmengen (50 MB oder mehr) herunterladen möchte, sollte sie diese Downloads streamen und nicht die Standardpufferung verwenden. Wenn Sie die Standardpufferung verwenden, wird die Clientspeicherauslastung sehr groß, was zu erheblich reduzierter Leistung führt.