SocketsHttpHandler Klasse

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Quelle:

SocketsHttpHandler.cs

Stellt den standardmäßigen Nachrichtenhandler bereit, der von HttpClient.

public ref class SocketsHttpHandler sealed : System::Net::Http::HttpMessageHandler

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public sealed class SocketsHttpHandler : System.Net.Http.HttpMessageHandler

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type SocketsHttpHandler = class
    inherit HttpMessageHandler

Public NotInheritable Class SocketsHttpHandler
Inherits HttpMessageHandler

Vererbung

Object

HttpMessageHandler

SocketsHttpHandler

Attribute

UnsupportedOSPlatformAttribute

Hinweise

Die SocketsHttpHandler Klasse stellt die Implementierung bereit, die von HTTP-Netzwerkklassen auf höherer Ebene verwendet wird, z HttpClient. B. . Die Verwendung von SocketsHttpHandler bietet eine Reihe von Vorteilen:

• Eine beträchtliche Leistungssteigerung im Vergleich zur früheren Implementierung.
• Die Beseitigung von Plattformabhängigkeiten, die die Bereitstellung und Wartung vereinfacht. Beispielsweise libcurl ist keine Abhängigkeit mehr von .NET für macOS und Linux.
• Einheitliches Verhalten auf allen .NET-Plattformen.

Konstruktoren

Name	Beschreibung
SocketsHttpHandler()	Erstellt eine Instanz einer SocketsHttpHandler Klasse.

Eigenschaften

Name	Beschreibung
ActivityHeadersPropagator	Ruft ab oder legt den Verteilungsverteiler fest, der beim Verteilen der verteilten Ablaufverfolgung und des Kontexts verwendet werden soll. Wird null verwendet, um die Verteilung zu deaktivieren.
AllowAutoRedirect	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Handler Umleitungsantworten folgen soll.
AutomaticDecompression	Dient zum Abrufen oder Festlegen des Typs der Dekomprimierungsmethode, die vom Handler für die automatische Dekomprimierung der HTTP-Inhaltsantwort verwendet wird.
ConnectCallback	Dient zum Abrufen oder Festlegen eines benutzerdefinierten Rückrufs, der zum Öffnen neuer Verbindungen verwendet wird.
ConnectTimeout	Dient zum Abrufen oder Festlegen des Zeitbereichs, der vor dem Herstellen von Zeitüberschreitungen für die Verbindung gewartet werden soll.
CookieContainer	Dient zum Abrufen oder Festlegen des verwalteten Cookiecontainerobjekts.
Credentials	Dient zum Abrufen oder Festlegen von Authentifizierungsinformationen, die von diesem Handler verwendet werden.
DefaultProxyCredentials	Wenn der Standardproxy (Systemproxy) verwendet wird, ruft die Anmeldeinformationen ab, die zum Senden an den Standardproxyserver für die Authentifizierung verwendet werden.
EnableMultipleHttp2Connections	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob zusätzliche HTTP/2-Verbindungen mit demselben Server hergestellt werden können.
EnableMultipleHttp3Connections	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob zusätzliche HTTP/3-Verbindungen mit demselben Server hergestellt werden können.
Expect100ContinueTimeout	Ruft den Timeoutwert für die Antwort http 100 Continue des Servers ab, oder legt diesen fest.
InitialHttp2StreamWindowSize	Definiert die anfängliche HTTP2-Datenstrom empfangen Fenstergröße für alle Verbindungen, die von diesem SocketsHttpHandlergeöffnet werden.
IsSupported	Ruft einen Wert ab, der angibt, ob der Handler auf der aktuellen Plattform unterstützt wird.
KeepAlivePingDelay	Dient zum Abrufen oder Festlegen der Keep Alive-Ping-Verzögerung.
KeepAlivePingPolicy	Dient zum Abrufen oder Festlegen des Keep Alive-Pingverhaltens.
KeepAlivePingTimeout	Dient zum Abrufen oder Festlegen des Keep-Ping-Timeouts.
MaxAutomaticRedirections	Ruft die maximale Anzahl zulässiger HTTP-Umleitungen ab oder legt diese fest.
MaxConnectionsPerServer	Ruft die maximale Anzahl gleichzeitiger TCP-Verbindungen ab, die mit einem einzelnen Server zulässig sind, oder legt diese fest.
MaxResponseDrainSize	Ruft die maximale Datenmenge ab, die aus Antworten in Bytes entwässert werden kann, oder legt diese fest.
MaxResponseHeadersLength	Ruft die maximale Länge in Kilobyte (1024 Byte) der Antwortheader ab oder legt sie fest.
MeterFactory	Dient zum Abrufen oder Festlegen des IMeterFactory Benutzerdefinierten Meter für die SocketsHttpHandler Instanz.
PlaintextStreamFilter	Dient zum Abrufen oder Festlegen eines benutzerdefinierten Rückrufs, der Zugriff auf den Nur-Text-HTTP-Protokolldatenstrom ermöglicht.
PooledConnectionIdleTimeout	Ruft ab oder legt fest, wie lange eine Verbindung im Leerlauf im Pool als wiederverwendbar betrachtet werden kann.
PooledConnectionLifetime	Ruft ab oder legt fest, wie lange eine Verbindung im Pool als wiederverwendbar betrachtet werden kann.
PreAuthenticate	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Handler einen Autorisierungsheader mit der Anforderung sendet.
Properties	Ruft ein schreibbares Wörterbuch (d. h. eine Zuordnung) von benutzerdefinierten Eigenschaften für die HttpClient-Anforderungen ab. Das Wörterbuch wird leer initialisiert; Sie können Schlüssel-Wert-Paare für Ihre benutzerdefinierten Handler und spezielle Verarbeitung einfügen und abfragen.
Proxy	Ruft den benutzerdefinierten Proxy ab, wenn die Eigenschaft ist, oder legt den UseProxy benutzerdefinierten Proxy fest true.
RequestHeaderEncodingSelector	Dient zum Abrufen oder Festlegen eines Rückrufs, der die Encoding zu codierenden Anforderungsheaderwerte auswählt.
ResponseDrainTimeout	Dient zum Abrufen oder Festlegen des Zeitbereichs, bis Daten aus Antworten entwässert werden.
ResponseHeaderEncodingSelector	Dient zum Abrufen oder Festlegen eines Rückrufs, der die Werte zum Decodieren der Encoding Antwortheader auswählt.
SslOptions	Ruft den Satz von Optionen ab, die für die Client-TLS-Authentifizierung verwendet werden, oder legt diese fest.
UseCookies	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Handler Cookies verwenden soll.
UseProxy	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Handler einen Proxy verwenden soll.

Methoden

Name	Beschreibung
Dispose()	Gibt die nicht verwalteten Ressourcen frei und entsorgt die verwalteten Ressourcen, die von der HttpMessageHandler. (Geerbt von HttpMessageHandler)
Dispose(Boolean)	Gibt die nicht verwalteten Ressourcen frei, die von den HttpMessageHandler verwalteten Ressourcen verwendet werden, und entfernt optional die verwalteten Ressourcen. (Geerbt von HttpMessageHandler)
Equals(Object)	Bestimmt, ob das angegebene Objekt dem aktuellen Objekt entspricht. (Geerbt von Object)
GetHashCode()	Dient als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
Send(HttpRequestMessage, CancellationToken)	Wenn eine abgeleitete Klasse außer Kraft gesetzt wird, sendet eine HTTP-Anforderung mit dem angegebenen Anforderungs- und Abbruchtoken. Andernfalls löst ein NotSupportedException. (Geerbt von HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)	Senden Sie eine HTTP-Anforderung als asynchronen Vorgang. (Geerbt von HttpMessageHandler)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)