Sdílet prostřednictvím


HttpClientHandler Třída

Definice

Výchozí obslužná rutina zpráv používaná v HttpClient rozhraní .NET Framework a .NET Core 2.0 a starších verzích.

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
Dědičnost
HttpClientHandler
Odvozené

Příklady

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

Poznámky

Další informace o tomto rozhraní API najdete v tématu Doplňkové poznámky k rozhraní API pro rutinu HttpClientHandler.

Konstruktory

HttpClientHandler()

Vytvoří instanci HttpClientHandler třídy.

Vlastnosti

AllowAutoRedirect

Získá nebo nastaví hodnotu, která označuje, zda obslužná rutina má následovat odpovědi přesměrování.

AutomaticDecompression

Získá nebo nastaví typ metody dekomprese používané obslužnou rutinou pro automatické dekompresi http obsah odpovědi.

CheckCertificateRevocationList

Získá nebo nastaví hodnotu, která označuje, zda je certifikát zkontrolován proti seznamu odvolaných certifikačních autorit.

ClientCertificateOptions

Získá nebo nastaví hodnotu, která označuje, zda je certifikát automaticky vybrán z úložiště certifikátů nebo zda volající je povoleno předat konkrétní klientský certifikát.

ClientCertificates

Získá kolekci certifikátů zabezpečení, které jsou přidruženy k požadavkům na server.

CookieContainer

Získá nebo nastaví kontejner souborů cookie sloužící k ukládání souborů cookie serveru obslužnou rutinou.

Credentials

Získá nebo nastaví ověřovací informace používané touto obslužnou rutinou.

DangerousAcceptAnyServerCertificateValidator

Získá delegáta uloženého v mezipaměti, který vždy vrátí true.

DefaultProxyCredentials

Při použití výchozího (systémového) proxy serveru získá nebo nastaví přihlašovací údaje k odeslání na výchozí proxy server k ověření. Výchozí proxy server se používá pouze v případech, kdy UseProxy je nastavená hodnota true a Proxy je nastavená na nullhodnotu .

MaxAutomaticRedirections

Získá nebo nastaví maximální počet přesměrování, které obslužná rutina sleduje.

MaxConnectionsPerServer

Získá nebo nastaví maximální počet souběžných připojení (na koncový bod serveru) povolený při provádění požadavků pomocí objektu HttpClient . Všimněte si, že limit je na koncový bod serveru, takže například hodnota 256 by umožňovala 256 souběžných připojení k http://www.adatum.com/ serveru a dalších 256 k http://www.adventure-works.com/.

MaxRequestContentBufferSize

Získá nebo nastaví maximální velikost vyrovnávací paměti obsahu požadavku používané obslužnou rutinou.

MaxResponseHeadersLength

Získá nebo nastaví maximální délku hlaviček odpovědi v kilobajtech (1024 bajtů). Pokud je například hodnota 64, je pro maximální délku hlaviček odpovědi povoleno 65536 bajtů.

MeterFactory

Získá nebo nastaví IMeterFactory k vytvoření vlastní Meter pro HttpClientHandler instanci.

PreAuthenticate

Získá nebo nastaví hodnotu, která označuje, zda obslužná rutina odešle autorizační hlavičku s požadavkem.

Properties

Získá zapisovatelný slovník (tj. mapu) vlastních vlastností pro HttpClient požadavky. Slovník je inicializován prázdný; Můžete vložit a dotazovat páry klíč-hodnota pro vlastní obslužné rutiny a speciální zpracování.

Proxy

Získá nebo nastaví informace proxy používané obslužnou rutinou.

ServerCertificateCustomValidationCallback

Získá nebo nastaví metodu zpětného volání k ověření certifikátu serveru.

SslProtocols

Získá nebo nastaví protokol TLS /SSL používané HttpClient objekty spravované HttpClientHandler objektu.

SupportsAutomaticDecompression

Získá hodnotu, která označuje, zda obslužná rutina podporuje automatickou dekompresi obsahu odpovědi.

SupportsProxy

Získá hodnotu, která označuje, zda obslužná rutina podporuje nastavení proxy.

SupportsRedirectConfiguration

Získá hodnotu, která označuje, zda obslužná rutina podporuje nastavení konfigurace pro AllowAutoRedirect vlastnosti a MaxAutomaticRedirections .

UseCookies

Získá nebo nastaví hodnotu, která označuje, zda obslužná rutina CookieContainer používá vlastnost k ukládání souborů cookie serveru a používá tyto soubory cookie při odesílání požadavků.

UseDefaultCredentials

Získá nebo nastaví hodnotu, která určuje, zda jsou výchozí přihlašovací údaje odeslány s požadavky obslužnou rutinou.

UseProxy

Získá nebo nastaví hodnotu, která označuje, zda obslužná rutina používá proxy pro požadavky.

Metody

Dispose()

Uvolní nespravované prostředky a odstraní spravované prostředky používané nástrojem HttpMessageHandler.

(Zděděno od HttpMessageHandler)
Dispose(Boolean)

Uvolní nespravované prostředky používané a HttpClientHandler volitelně odstraní spravované prostředky.

Equals(Object)

Určí, zda se zadaný objekt rovná aktuálnímu objektu.

(Zděděno od Object)
GetHashCode()

Slouží jako výchozí hashovací funkce.

(Zděděno od Object)
GetType()

Type Získá z aktuální instance.

(Zděděno od Object)
MemberwiseClone()

Vytvoří mělkou kopii aktuálního Objectsouboru .

(Zděděno od Object)
Send(HttpRequestMessage, CancellationToken)

Vytvoří instanci objektu HttpResponseMessage na základě informací zadaných v objektu HttpRequestMessage.

Send(HttpRequestMessage, CancellationToken)

Při přepsání v odvozené třídě odešle požadavek HTTP se zadaným tokenem požadavku a zrušení. V opačném případě vyvolá NotSupportedException.

(Zděděno od HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)

Vytvoří instanci na základě informací zadaných HttpResponseMessage v jako HttpRequestMessage operace, která nebude blokovat.

ToString()

Vrátí řetězec, který představuje aktuální objekt.

(Zděděno od Object)

Platí pro

Viz také