HttpClientHandler Klasse

Definition

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
HttpClientHandler
Abgeleitet

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.

Send(HttpRequestMessage, CancellationToken)

Sendet eine HTTP-Anforderung mit der angegebenen Anforderung und einem Abbruchtoken, wenn eine Überschreibung in einer abgeleiteten Klasse erfolgt. Löst andernfalls eine NotSupportedException aus.

(Geerbt von HttpMessageHandler)
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)

Gilt für:

Weitere Informationen