HttpClientHandler Třída

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

Zdroj:

HttpClientHandler.cs

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

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 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.
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)

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
• HttpClient – ukázka