HttpClientHandler Klasse

Definition

Namespace:

System.Net.Http

Assemblys:

netstandard.dll, System.Net.Http.dll

Quelle:

HttpClientHandler.cs

Der standardmäßige Nachrichtenhandler, der von HttpClient .NET Framework 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 in den ergänzenden API-Hinweisen für HttpClientHandler.

Konstruktoren

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

Eigenschaften

Name	Beschreibung
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.
CheckCertificateRevocationList	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Zertifikat für die Sperrliste der Zertifizierungsstelle überprüft wird.
ClientCertificateOptions	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob das Zertifikat automatisch aus dem Zertifikatspeicher ausgewählt wird oder ob der Aufrufer ein bestimmtes Clientzertifikat übergeben darf.
ClientCertificates	Ruft die Sammlung von Sicherheitszertifikaten ab, die Anforderungen an den Server zugeordnet sind.
CookieContainer	Ruft den Cookiecontainer ab, der zum Speichern von Servercookies vom Handler verwendet wird, oder legt diesen fest.
Credentials	Dient zum Abrufen oder Festlegen von Authentifizierungsinformationen, die von diesem Handler verwendet werden.
DangerousAcceptAnyServerCertificateValidator	Ruft einen zwischengespeicherten Delegaten ab, der immer zurückgegeben wird true.
DefaultProxyCredentials	Wenn der Standardproxy (System) verwendet wird, ruft die Anmeldeinformationen ab oder legt sie fest, die an den Standardproxyserver für die Authentifizierung gesendet werden sollen. Der Standardproxy wird nur verwendet, wenn UseProxy er auf true " Proxy und auf" nullfestgelegt ist.
MaxAutomaticRedirections	Ruft die maximale Anzahl von Umleitungen ab, die der Handler folgt, oder legt diese fest.
MaxConnectionsPerServer	Ruft ab oder legt die maximale Anzahl gleichzeitiger Verbindungen (pro Serverendpunkt) zulässig, wenn Anforderungen mithilfe eines HttpClient Objekts ausgeführt werden. Beachten Sie, dass der Grenzwert pro Serverendpunkt liegt, sodass beispielsweise ein Wert von 256 gleichzeitige Verbindungen mit http://www.adatum.com/ 256 und einem weiteren Wert von 256 zulässt http://www.adventure-works.com/.
MaxRequestContentBufferSize	Ruft die maximale Größe des Anforderungsinhaltspuffers ab, die vom Handler verwendet wird, oder legt diese fest.
MaxResponseHeadersLength	Ruft die maximale Länge in Kilobyte (1024 Byte) der Antwortheader ab oder legt sie fest. Wenn der Wert beispielsweise 64 ist, sind 65536 Bytes für die maximale Länge der Antwortheader zulässig.
MeterFactory	Dient zum Abrufen oder Festlegen des IMeterFactory Benutzerdefinierten Meter für die HttpClientHandler Instanz.
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	Dient zum Abrufen oder Festlegen von Proxyinformationen, die vom Handler verwendet werden.
ServerCertificateCustomValidationCallback	Dient zum Abrufen oder Festlegen einer Rückrufmethode zum Überprüfen des Serverzertifikats.
SslProtocols	Dient zum Abrufen oder Festlegen der TLS/SSL-Protokolle, die von den Objekten verwendet werden, die HttpClient vom HttpClientHandler -Objekt verwaltet werden.
SupportsAutomaticDecompression	Ruft einen Wert ab, der angibt, ob der Handler die Dekomprimierung der automatischen Antwortinhalte 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 AllowAutoRedirect und MaxAutomaticRedirections eigenschaften unterstützt.
UseCookies	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Handler die CookieContainer Eigenschaft zum Speichern von Servercookies verwendet und diese Cookies beim Senden von Anforderungen verwendet.
UseDefaultCredentials	Dient zum Abrufen oder Festlegen eines Werts, der steuert, ob Standardanmeldeinformationen mit Anforderungen vom Handler gesendet werden.
UseProxy	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Handler einen Proxy für Anforderungen verwendet.

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 HttpClientHandler verwalteten Ressourcen verwendet werden, und entfernt optional die verwalteten Ressourcen.
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)	Erstellt eine Instanz basierend HttpResponseMessage auf den informationen, die in der HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Erstellt eine Instanz HttpResponseMessage basierend auf den Informationen, die HttpRequestMessage im Rahmen eines Vorgangs bereitgestellt werden, der 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 mit HttpClient
• Verwenden von HttpClient-Handlern
• So sichern Sie HttpClient-Verbindungen