Udostępnij za pośrednictwem


HttpClientHandler Klasa

Definicja

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
HttpClientHandler
Pochodne

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.

Send(HttpRequestMessage, CancellationToken)

Po zastąpieniu w klasie pochodnej wysyła żądanie HTTP z określonym żądaniem i tokenem anulowania. W przeciwnym razie zwraca wartość NotSupportedException.

(Odziedziczone po HttpMessageHandler)
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)

Dotyczy

Zobacz też