Dieser Artikel wurde noch nicht bewertet - Dieses Thema bewerten.

HttpClientHandler-Klasse

.NET Framework 4.5

Der standardmäßige Meldungshandler für HttpClient.

System.Object
  System.Net.Http.HttpMessageHandler
    System.Net.Http.HttpClientHandler
      System.Net.Http.WebRequestHandler

Namespace: System.Net.Http
Assembly: System.Net.Http (in System.Net.Http.dll)

Syntax

C++

public class HttpClientHandler : HttpMessageHandler

Der HttpClientHandler-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	HttpClientHandler	Erstellt eine Instanz einer HttpClientHandler-Klasse.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	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 der HTTP-Inhalt-Antwort verwendet wird, oder legt diesen fest.
	ClientCertificateOptions	Ruft die diesem Handler zugeordnete Auflistung von Sicherheitszertifikaten ab oder legt diese fest.
	CookieContainer	Ruft den Cookiecontainer zum Speichern von Servercookies durch den Handler ab oder diesen fest.
	Credentials	Ruft die Authentifizierungsinformationen ab, die vom Handler verwendet wurden, oder legt diese fest.
	MaxAutomaticRedirections	Ruft die maximale Anzahl von Umleitungen ab, denen der Handler folgt, oder legt diese fest.
	MaxRequestContentBufferSize	Ruft die maximale Größe des Anforderungsinhaltpuffers ab, der vom Handler verwendet wird, oder legt diese fest.
	PreAuthenticate	Ruft einen Wert ab, der angibt, ob der Handler mit der Anforderung ein Autorisierungsheader sendet, oder legt diesen fest.
	Proxy	Ruft die Proxyinformationen ab, die vom Handler verwendet werden, oder legt diese fest.
	SupportsAutomaticDecompression	Ruft einen Wert ab, der angibt, ob der Handler die automatische Antwort-Inhaltsdekomprimierung unterstützt.
	SupportsProxy	Ruft einen Wert ab, der angibt, ob der Handler die Proxyeinstellungen unterstützt.
	SupportsRedirectConfiguration	Ruft einen Wert ab, der angibt, ob der Handler Konfigurationseinstellungen für die AllowAutoRedirect- und MaxAutomaticRedirections-Eigenschaften unterstützt.
	UseCookies	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Handler die CookieContainer-Eigenschaft zum Speichern von Servercookies verwendet und die Cookies beim Senden von Anforderungen nutzt.
	UseDefaultCredentials	Ruft einen Wert ab, der steuert, ob mit den Anforderungen vom Handler Standardanmeldeinformationen gesendet werden, oder legt diesen fest.
	UseProxy	Ruft einen Wert ab bzw. legt einen Wert fest, der angibt, ob der Handler einen Proxy für Anforderungen verwendet.

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Dispose()	Gibt die vom HttpMessageHandler verwendeten, nicht verwalteten Ressourcen frei und verwirft die verwalteten Ressourcen. (Von HttpMessageHandler geerbt.)
	Dispose(Boolean)	Gibt die vom HttpClientHandler verwendeten, nicht verwalteten Ressourcen frei und verwirft optional auch die verwalteten Ressourcen. (Überschreibt HttpMessageHandler.Dispose(Boolean).)
	Equals(Object)	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	Finalize	Gibt einem Objekt Gelegenheit, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird. (Von Object geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetType	Ruft den Type der aktuellen Instanz ab. (Von Object geerbt.)
	MemberwiseClone	Erstellt eine flache Kopie des aktuellen Object. (Von Object geerbt.)
	SendAsync	Erstellt eine Instanz von HttpResponseMessage auf Grundlage der Informationen, die in HttpRequestMessage als Operation bereitgestellt werden, der nicht blockiert. (Überschreibt HttpMessageHandler.SendAsync(HttpRequestMessage, CancellationToken).)
	ToString	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Von Object geerbt.)

Zum Seitenanfang

Hinweise

Die HttpClientHandler-Klasse und Klassen, die davon abgeleitet werden, ermöglichen Entwicklern, um eine Vielzahl von Optionen zu konfigurieren, die von Proxy zu Authentifizierung reichen.

Beispiele


  static async void Main()
	{
    try	
    {
      HttpClientHandler handler = new HttpClientHandler();
      handler.UseDefaultCredentials = true;
      // Create a New HttpClient object.
      HttpClient client = new HttpClient(handler);
      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);
    }
  }

Versionsinformationen

.NET Framework

Unterstützt in: 4.5

.NET für Windows Store-Apps

Unterstützt in: Windows 8

Plattformen

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core-Rolle wird nicht unterstützt), Windows Server 2008 R2 (Server Core-Rolle wird mit SP1 oder höher unterstützt; Itanium wird nicht unterstützt)

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

System.Net.Http-Namespace

Weitere Ressourcen

Verbindung mit einem Webdienst

Mobile-Schnellstart-Lernprogrammen: Verbindung mit HttpClient

Erstellen HttpClient-Handler verwendet

Erstellen HttpClient-Verbindungen gespeichert werden

HttpClient-Beispiel

Fanden Sie dies hilfreich? Ja Nein

Nicht genau

Keine ausreichende Tiefe

Weitere Codebeispiele erforderlich

Die Übersetzung sollte verbessert werden.

(1500 verbleibende Zeichen)

Community-Beiträge

HINZUFÜGEN