HttpClientHandler Klasse

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Quelle:

HttpClientHandler.cs

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

public ref class HttpClientHandler : System::Net::Http::HttpMessageHandler

public class HttpClientHandler : System.Net.Http.HttpMessageHandler

type HttpClientHandler = class
    inherit HttpMessageHandler

Public Class HttpClientHandler
Inherits HttpMessageHandler

Vererbung

Object

HttpMessageHandler

HttpClientHandler

Abgeleitet

System.Net.Http.WebRequestHandler

Beispiele

static async Task Main()
{
   // Create an HttpClientHandler object and set to use default credentials
   HttpClientHandler handler = new HttpClientHandler();
   handler.UseDefaultCredentials = true;

   // Create an HttpClient object
   HttpClient client = new HttpClient(handler);

   // Call asynchronous network methods in a try/catch block to handle exceptions
   try
   {
      HttpResponseMessage response = await client.GetAsync("http://www.contoso.com/");

      response.EnsureSuccessStatusCode();

      string responseBody = await response.Content.ReadAsStringAsync();
      Console.WriteLine(responseBody);
   }
   catch(HttpRequestException e)
   {
       Console.WriteLine("\nException Caught!");
       Console.WriteLine("Message :{0} ",e.Message);
   }

   // Need to call dispose on the HttpClient and HttpClientHandler objects
   // when done using them, so the app doesn't leak resources
   handler.Dispose();
   client.Dispose();
}

Hinweise

Weitere Informationen zu dieser API finden Sie unter Zusätzliche API-Hinweise für HttpClientHandler.

Konstruktoren

HttpClientHandler()

Erstellt eine Instanz einer HttpClientHandler-Klasse.

Eigenschaften

AllowAutoRedirect	Ruft einen Wert ab, der angibt, ob der Handler Umleitungsantworten folgen soll, oder legt diesen Wert fest.
AutomaticDecompression	Ruft den Typ der Dekomprimierungsmethode ab, die vom Handler für die automatische Dekomprimierung von Antworten mit HTTP-Inhalt verwendet wird, oder legt den Typ fest.
CheckCertificateRevocationList	Ruft einen Wert ab, der angibt, ob das Zertifikat anhand der Sperrliste der Zertifizierungsstelle überprüft wird, oder legt diesen fest.
ClientCertificateOptions	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Zertifikat automatisch aus dem Zertifikatspeicher ausgewählt wird oder ob der Aufrufer ein bestimmtes Clientzertifikat übergeben darf.
ClientCertificates	Ruft die Auflistung von Sicherheitszertifikaten ab, die Anforderungen an den Server zugeordnet sind.
CookieContainer	Ruft den zum Speichern von Servercookies vom Handler verwendeten Cookiecontainer ab oder legt diesen fest.
Credentials	Ruft von diesem Handler verwendete Authentifizierungsinformationen ab oder legt diese fest.
DangerousAcceptAnyServerCertificateValidator	Ruft einen zwischengespeicherten Delegaten ab, der immer true zurückgibt.
DefaultProxyCredentials	Wenn der Standardproxy (Systemproxy) verwendet wird, werden die Anmeldeinformationen abgerufen oder festgelegt, die an den Standardproxyserver für die Authentifizierung übermittelt werden. Der Standardproxy wird nur verwendet, wenn UseProxy auf true und Proxy auf null festgelegt ist.
MaxAutomaticRedirections	Ruft die maximale Anzahl von Umleitungen ab, denen der Handler folgt, oder legt diese fest.
MaxConnectionsPerServer	Ruft die maximal zulässige Anzahl gleichzeitiger Verbindungen (pro Serverendpunkt), wenn eine Anforderung mithilfe eines HttpClient-Objekts durchgeführt wird, oder legt diese fest. Beachten Sie, dass der Grenzwert pro Serverendpunkt gilt. Ein Wert von 256 würde beispielsweise 256 gleichzeitige Verbindungen zu „http://www.adatum.com/“ und weitere 256 zu „http://www.adventure-works.com/“ ermöglichen.
MaxRequestContentBufferSize	Dient zum Abrufen oder Festlegen der maximalen Größe des Anforderungsinhaltspuffers, die vom Handler verwendet wird.
MaxResponseHeadersLength	Ruft die maximale Länge des Antwortheaders in Kilobyte (1024 Byte) ab oder legt diese fest. Wenn der Wert beispielsweise 64 ist, sind 65536 Byte für die maximale Länge des Antwortheaders zulässig.
MeterFactory	Ruft den IMeterFactory ab, um einen benutzerdefinierten Meter für die HttpClientHandler instance zu erstellen, oder legt diesen fest.
PreAuthenticate	Ruft einen Wert ab, der angibt, ob vom Handler mit der Anforderung ein Autorisierungsheader gesendet wird, oder legt diesen fest.
Properties	Ruft ein beschreibares Wörterbuch (d.h. eine Zuordnung) von benutzerdefinierten Eigenschaften für die HttpClient-Anforderungen ab. Das Wörterbuch ist zunächst leer. Sie können Schlüssel-Wert-Paare für benutzerdefinierte Handler und die spezielle Verarbeitung einfügen und abfragen.
Proxy	Ruft vom Handler verwendete Proxyinformationen ab oder legt diese fest.
ServerCertificateCustomValidationCallback	Ruft eine Rückrufmethode zur Überprüfung des Serverzertifikats ab oder legt diese fest.
SslProtocols	Ruft das TSL-/SSL-Protokoll ab, das von den HttpClient-Objekten verwendet wird, die vom HttpClientHandler-Objekt verwaltet werden, oder legt dieses fest.
SupportsAutomaticDecompression	Ruft einen Wert ab, der angibt, ob der Handler die automatische Dekomprimierung von Antwortinhalten unterstützt.
SupportsProxy	Ruft einen Wert ab, der angibt, ob der Handler Proxyeinstellungen unterstützt.
SupportsRedirectConfiguration	Ruft einen Wert ab, der angibt, ob der Handler Konfigurationseinstellungen für die Eigenschaften AllowAutoRedirect und MaxAutomaticRedirections unterstützt.
UseCookies	Ruft einen Wert ab, der angibt, ob der Handler die CookieContainer Eigenschaft verwendet, um Servercookies zu speichern, und verwendet diese Cookies beim Senden von Anforderungen.
UseDefaultCredentials	Ruft einen Wert ab, der steuert, ob vom Handler mit den Anforderungen Standardanmeldeinformationen gesendet werden, oder legt diesen fest.
UseProxy	Ruft einen Wert ab, der angibt, ob der Handler einen Proxy für Anforderungen verwendet, oder legt diesen Wert fest.

Methoden

Dispose()	Gibt die vom HttpMessageHandler verwendeten, nicht verwalteten Ressourcen frei und verwirft die verwalteten Ressourcen. (Geerbt von HttpMessageHandler)
Dispose(Boolean)	Gibt die vom HttpClientHandler verwendeten, nicht verwalteten Ressourcen frei und verwirft optional auch die verwalteten Ressourcen.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
Send(HttpRequestMessage, CancellationToken)	Erstellt eine instance von HttpResponseMessage basierend auf den in bereitgestellten HttpRequestMessageInformationen.
SendAsync(HttpRequestMessage, CancellationToken)	Erstellt eine instance von HttpResponseMessage basierend auf den Informationen, die in als ein Vorgang bereitgestellt werden, der HttpRequestMessage nicht blockiert wird.
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Weitere Informationen

• Herstellen einer Verbindung mit einem Webdienst
• Schnellstart: Herstellen einer Verbindung mithilfe von HttpClient
• Verwenden des HttpClient-Handlers
• Sichern von HttpClient-Verbindungen
• HttpClient Sample (HttpClient-Beispiel)