SocketsHttpHandler Klasse
Definition
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 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.HttpMessageHandlerpublic sealed class SocketsHttpHandler : System.Net.Http.HttpMessageHandler[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type SocketsHttpHandler = class
inherit HttpMessageHandlertype SocketsHttpHandler = class
inherit HttpMessageHandlerPublic NotInheritable Class SocketsHttpHandler
Inherits HttpMessageHandler- Vererbung
- Attribute
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
libcurlist 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 |
| 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 |
| 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) |
