HttpClientHandler Klasa

Definicja

Przestrzeń nazw:

System.Net.Http

Zestawy:

netstandard.dll, System.Net.Http.dll

Źródło:

HttpClientHandler.cs

Domyślna procedura obsługi komunikatów używana przez HttpClient program .NET Framework.

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

Dziedziczenie

Object

HttpMessageHandler

HttpClientHandler

Pochodne

System.Net.Http.WebRequestHandler

Przykłady

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();
}

Uwagi

Aby uzyskać więcej informacji na temat tego interfejsu API, zobacz Dodatkowe uwagi dotyczące interfejsu API dla programu HttpClientHandler.

Konstruktory

Nazwa	Opis
HttpClientHandler()	Tworzy wystąpienie HttpClientHandler klasy.

Właściwości

Nazwa	Opis
AllowAutoRedirect	Pobiera lub ustawia wartość wskazującą, czy program obsługi powinien postępować zgodnie z odpowiedziami przekierowania.
AutomaticDecompression	Pobiera lub ustawia typ metody dekompresji używanej przez program obsługi do automatycznego dekompresji odpowiedzi zawartości HTTP.
CheckCertificateRevocationList	Pobiera lub ustawia wartość wskazującą, czy certyfikat jest sprawdzany względem listy odwołania urzędu certyfikacji.
ClientCertificateOptions	Pobiera lub ustawia wartość wskazującą, czy certyfikat jest automatycznie wybierany z magazynu certyfikatów, czy obiekt wywołujący może przekazać określony certyfikat klienta.
ClientCertificates	Pobiera kolekcję certyfikatów zabezpieczeń skojarzonych z żądaniami do serwera.
CookieContainer	Pobiera lub ustawia kontener plików cookie używany do przechowywania plików cookie serwera przez program obsługi.
Credentials	Pobiera lub ustawia informacje uwierzytelniania używane przez tę procedurę obsługi.
DangerousAcceptAnyServerCertificateValidator	Pobiera buforowany delegat, który zawsze zwraca wartość true.
DefaultProxyCredentials	Gdy jest używany domyślny (systemowy) serwer proxy, pobiera lub ustawia poświadczenia do przesłania do domyślnego serwera proxy na potrzeby uwierzytelniania. Domyślny serwer proxy jest używany tylko wtedy, gdy UseProxy jest ustawiony na true wartość i Proxy ma wartość null.
MaxAutomaticRedirections	Pobiera lub ustawia maksymalną liczbę przekierowań, które następuje w programie obsługi.
MaxConnectionsPerServer	Pobiera lub ustawia maksymalną liczbę współbieżnych połączeń (na punkt końcowy serwera) dozwolonych podczas przesyłania żądań przy użyciu HttpClient obiektu. Należy pamiętać, że limit jest na punkt końcowy serwera, więc na przykład wartość 256 zezwala na 256 równoczesnych połączeń z http://www.adatum.com/ i kolejne 256 do http://www.adventure-works.com/.
MaxRequestContentBufferSize	Pobiera lub ustawia maksymalny rozmiar buforu zawartości żądania używanego przez program obsługi.
MaxResponseHeadersLength	Pobiera lub ustawia maksymalną długość w kilobajtach (1024 bajty) nagłówków odpowiedzi. Jeśli na przykład wartość to 64, maksymalna długość nagłówków odpowiedzi to 65536 bajtów.
MeterFactory	Pobiera lub ustawia element IMeterFactory w celu utworzenia niestandardowego HttpClientHandlerMeter dla wystąpienia.
PreAuthenticate	Pobiera lub ustawia wartość wskazującą, czy program obsługi wysyła nagłówek autoryzacji z żądaniem.
Properties	Pobiera słownik zapisywalny (czyli mapę) właściwości niestandardowych dla HttpClient żądań. Słownik jest inicjowany jako pusty; Można wstawić pary klucz-wartość i wykonywać zapytania dla niestandardowych procedur obsługi i specjalnego przetwarzania.
Proxy	Pobiera lub ustawia informacje o serwerze proxy używane przez program obsługi.
ServerCertificateCustomValidationCallback	Pobiera lub ustawia metodę wywołania zwrotnego w celu zweryfikowania certyfikatu serwera.
SslProtocols	Pobiera lub ustawia protokoły TLS/SSL używane przez HttpClient obiekty zarządzane przez obiekt HttpClientHandler.
SupportsAutomaticDecompression	Pobiera wartość wskazującą, czy program obsługi obsługuje dekompresację zawartości odpowiedzi automatycznej.
SupportsProxy	Pobiera wartość wskazującą, czy program obsługi obsługuje ustawienia serwera proxy.
SupportsRedirectConfiguration	Pobiera wartość wskazującą, czy program obsługi obsługuje ustawienia konfiguracji dla AllowAutoRedirect właściwości i MaxAutomaticRedirections .
UseCookies	Pobiera lub ustawia wartość wskazującą, czy program obsługi używa CookieContainer właściwości do przechowywania plików cookie serwera i używa tych plików cookie podczas wysyłania żądań.
UseDefaultCredentials	Pobiera lub ustawia wartość, która określa, czy poświadczenia domyślne są wysyłane z żądaniami przez program obsługi.
UseProxy	Pobiera lub ustawia wartość wskazującą, czy program obsługi używa serwera proxy dla żądań.

Metody

Nazwa	Opis
Dispose()	Zwalnia niezarządzane zasoby i usuwa zarządzane zasoby używane przez program HttpMessageHandler. (Odziedziczone po HttpMessageHandler)
Dispose(Boolean)	Zwalnia niezarządzane zasoby używane przez HttpClientHandler program i opcjonalnie usuwa zasoby zarządzane.
Equals(Object)	Określa, czy określony obiekt jest równy bieżącemu obiektowi. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Pobiera Type bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Object. (Odziedziczone po Object)
Send(HttpRequestMessage, CancellationToken)	Tworzy wystąpienie HttpResponseMessage oparte na informacjach podanych w pliku HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Tworzy wystąpienie HttpResponseMessage na podstawie informacji podanych w HttpRequestMessage operacji, która nie zostanie zablokowana.
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Zobacz też

• Nawiązywanie połączenia z usługą internetową
• Szybki start: nawiązywanie połączenia przy użyciu klienta HttpClient
• Jak używać programów obsługi HttpClient
• Jak zabezpieczyć połączenia HttpClient