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 w HttpClient systemach .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 automatycznej 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 i Proxy jest ustawiony na 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 wykonywania żą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 bajtów) nagłówków odpowiedzi. Jeśli na przykład wartość to 64, 65536 bajtów jest dozwolone dla maksymalnej długości nagłówków odpowiedzi.
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 żądań HttpClient . 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 protokół TLS/SSL używany przez obiekty zarządzane przez HttpClient 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 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 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 wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
Send(HttpRequestMessage, CancellationToken)	Tworzy wystąpienie HttpResponseMessage klasy na podstawie informacji podanych w pliku HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Tworzy wystąpienie HttpResponseMessage obiektu na podstawie informacji podanych w elemecie HttpRequestMessage jako operacji, która nie będzie blokować.
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