HttpClientHandler Klasa

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

Źródło:

HttpClientHandler.cs

Domyślna procedura obsługi komunikatów używana HttpClient w programach .NET Framework i .NET Core 2.0 i starszych.

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

HttpClientHandler()

Tworzy wystąpienie HttpClientHandler klasy.

Właściwości

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 truewartość .
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 i Proxy jest ustawiony na null.
MaxAutomaticRedirections	Pobiera lub ustawia maksymalną liczbę przekierowań, które następuje program obsługi.
MaxConnectionsPerServer	Pobiera lub ustawia maksymalną liczbę współbieżnych połączeń (na punkt końcowy serwera) dozwolonych podczas wysyłania żądań przy użyciu HttpClient obiektu. Należy pamiętać, że limit dotyczy punktu końcowego 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, dla maksymalnej długości nagłówków odpowiedzi dozwolone są 65536 bajty.
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 zapisywalny słownik (czyli mapę) właściwości niestandardowych dla HttpClient żądań. Słownik jest inicjowany jako pusty; Pary klucz-wartość można wstawić i wykonać 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 protokół TLS/SSL używany przez HttpClient obiekty zarządzane przez obiekt HttpClientHandler.
SupportsAutomaticDecompression	Pobiera wartość wskazującą, czy program obsługi obsługuje dekompresję 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

Dispose()	Zwalnia niezarządzane zasoby i usuwa zasoby zarządzane używane przez HttpMessageHandlerprogram . (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 dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera bieżące wystąpienie. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Send(HttpRequestMessage, CancellationToken)	Tworzy wystąpienie oparte na informacjach HttpResponseMessage podanych w pliku HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Tworzy wystąpienie oparte na informacjach podanych HttpResponseMessage 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
• Przykład httpclient