HttpClientHandler Třída

Definice

Obor názvů:

System.Net.Http

Sestavení:

netstandard.dll, System.Net.Http.dll

Zdroj:

HttpClientHandler.cs

Výchozí obslužná rutina zpráv používaná HttpClient v rozhraní .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

Dědičnost

Object

HttpMessageHandler

HttpClientHandler

Odvozené

System.Net.Http.WebRequestHandler

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 naleznete v tématu Doplňkové poznámky k rozhraní API pro HttpClientHandler.

Konstruktory

Name	Description
HttpClientHandler()	Vytvoří instanci HttpClientHandler třídy.

Vlastnosti

Name	Description
AllowAutoRedirect	Získá nebo nastaví hodnotu, která určuje, zda obslužná rutina má následovat odpovědi přesměrování.
AutomaticDecompression	Získá nebo nastaví typ dekomprese metoda používaná obslužnou rutinou pro automatické dekompresi odpovědi http obsahu.
CheckCertificateRevocationList	Získá nebo nastaví hodnotu, která určuje, zda je certifikát kontrolován v 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 pokud volající může předat konkrétní klientský certifikát.
ClientCertificates	Získá kolekci certifikátů zabezpečení, které jsou přidružené k požadavkům na server.
CookieContainer	Získá nebo nastaví kontejner cookie použitý 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át v mezipaměti, který vždy vrátí true.
DefaultProxyCredentials	Pokud se používá výchozí (systémový) proxy server, získá nebo nastaví přihlašovací údaje pro odeslání na výchozí proxy server pro ověření. Výchozí proxy server se používá pouze v případech, kdy UseProxy je nastavená true hodnota a Proxy je nastavena na nullhodnotu .
MaxAutomaticRedirections	Získá nebo nastaví maximální počet přesměrování, které obslužná rutina ná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 platí pro koncový bod serveru, takže například hodnota 256 by umožňovala 256 souběžných připojení k http://www.adatum.com/ a dalších 256 do http://www.adventure-works.com/.
MaxRequestContentBufferSize	Získá nebo nastaví maximální velikost vyrovnávací paměti obsahu požadavku používanou obslužnou rutinou.
MaxResponseHeadersLength	Získá nebo nastaví maximální délku v kilobajtech (1024 bajtů) hlaviček odpovědi. Pokud je například hodnota 64, 65536 bajtů jsou povoleny pro maximální délku záhlaví odpovědi.
MeterFactory	Získá nebo nastaví IMeterFactory vytvořit vlastní Meter instanci HttpClientHandler .
PreAuthenticate	Získá nebo nastaví hodnotu, která určuje, zda obslužná rutina odešle autorizační hlavičku s požadavkem.
Properties	Získá zapisovatelný slovník (tj. mapa) vlastních vlastností pro HttpClient požadavky. Slovník je inicializován prázdný; Můžete vkládat 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í protokoly TLS/SSL používané HttpClient objekty spravované HttpClientHandler objektu.
SupportsAutomaticDecompression	Získá hodnotu, která označuje, zda obslužná rutina podporuje automatické dekomprese obsahu odpovědi.
SupportsProxy	Získá hodnotu, která označuje, zda obslužná rutina podporuje nastavení proxy.
SupportsRedirectConfiguration	Získá hodnotu, která určuje, zda obslužná rutina podporuje nastavení konfigurace pro vlastnosti AllowAutoRedirect a MaxAutomaticRedirections vlastnosti.
UseCookies	Získá nebo nastaví hodnotu, která určuje, zda obslužná rutina používá CookieContainer 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 odesílá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

Name	Description
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é spravovanými HttpClientHandler prostředky a volitelně zlikviduje spravované prostředky.
Equals(Object)	Určuje, zda je zadaný objekt roven aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí funkce hash. (Zděděno od Object)
GetType()	Získá Type aktuální instance. (Zděděno od Object)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Object. (Zděděno od Object)
Send(HttpRequestMessage, CancellationToken)	Vytvoří instanci HttpResponseMessage na základě informací uvedených v objektu HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Vytvoří instanci HttpResponseMessage na základě informací uvedených v HttpRequestMessage operaci, která nebude blokovat.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• Připojení k webové službě
• Rychlý start: Připojení pomocí HttpClient
• Jak používat obslužné rutiny HttpClient
• Jak zabezpečit připojení HttpClient