HttpClientHandler Osztály

Definíció

Névtér:

System.Net.Http

Szerelvények:

netstandard.dll, System.Net.Http.dll

Forrás:

HttpClientHandler.cs

A HttpClient által a .NET-keretrendszerben használt alapértelmezett üzenetkezelő.

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

Öröklődés

Object

HttpMessageHandler

HttpClientHandler

Származtatott

System.Net.Http.WebRequestHandler

Példák

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

Megjegyzések

Az API-val kapcsolatos további információkért lásd a HttpClientHandler kiegészítő API-megjegyzéseit.

Konstruktorok

Name	Description
HttpClientHandler()	Létrehoz egy osztálypéldányt HttpClientHandler .

Tulajdonságok

Name	Description
AllowAutoRedirect	Lekéri vagy beállít egy értéket, amely jelzi, hogy a kezelőnek követnie kell-e az átirányítási válaszokat.
AutomaticDecompression	Lekéri vagy beállítja a http-tartalomválasz automatikus dekompressziós megoldásához a kezelő által használt dekompressziós metódus típusát.
CheckCertificateRevocationList	Lekéri vagy beállít egy értéket, amely jelzi, hogy a tanúsítvány a hitelesítésszolgáltató visszavonási listájában van-e ellenőrizve.
ClientCertificateOptions	Lekéri vagy beállít egy értéket, amely jelzi, hogy a tanúsítvány automatikusan ki van-e választva a tanúsítványtárolóból, vagy hogy a hívónak engedélyezve van-e egy adott ügyféltanúsítvány átadása.
ClientCertificates	Lekéri a kiszolgálóhoz érkező kérésekhez társított biztonsági tanúsítványok gyűjteményét.
CookieContainer	Lekéri vagy beállítja a kiszolgálói cookie-k kezelő által történő tárolására használt cookie-tárolót.
Credentials	Lekéri vagy beállítja a kezelő által használt hitelesítési adatokat.
DangerousAcceptAnyServerCertificateValidator	Lekéri a mindig visszaadott gyorsítótárazott delegáltat true.
DefaultProxyCredentials	Ha az alapértelmezett (rendszer-) proxyt használja, lekéri vagy beállítja a hitelesítő adatokat az alapértelmezett proxykiszolgálóra való hitelesítéshez. Az alapértelmezett proxyt csak akkor használja a rendszer, ha UseProxy be van állítva true és Proxy be van állítva null.
MaxAutomaticRedirections	Lekéri vagy beállítja a kezelő által követett átirányítások maximális számát.
MaxConnectionsPerServer	Lekéri vagy beállítja az egyidejű kapcsolatok maximális számát (kiszolgálóvégpontonként) az objektumok használatával HttpClient történő kérések során. Vegye figyelembe, hogy a korlát kiszolgálóvégpontonként van, így például egy 256-os érték 256 egyidejű kapcsolatot http://www.adatum.com/ tesz lehetővé, és további 256-ot.http://www.adventure-works.com/
MaxRequestContentBufferSize	Lekéri vagy beállítja a kérelem tartalompufferének maximális méretét, amelyet a kezelő használ.
MaxResponseHeadersLength	Lekéri vagy beállítja a válaszfejlécek maximális hosszát kilobájtban (1024 bájt). Ha például az érték 64, akkor a válaszfejlécek maximális hosszához 65536 bájt adható meg.
MeterFactory	Lekéri vagy beállítja, IMeterFactory hogy létrehozhasson egy egyéni Meter példányt.HttpClientHandler
PreAuthenticate	Lekéri vagy beállít egy értéket, amely jelzi, hogy a kezelő elküldi-e az Engedélyezési fejlécet a kéréssel együtt.
Properties	Lekéri a kérések egyéni tulajdonságainak HttpClient írható szótárát (vagyis térképét). A szótár inicializálása üres; Kulcs-érték párokat szúrhat be és kérdezhet le az egyéni kezelőkhöz és a speciális feldolgozáshoz.
Proxy	Lekéri vagy beállítja a kezelő által használt proxyadatokat.
ServerCertificateCustomValidationCallback	Lekéri vagy beállítja a visszahívási módszert a kiszolgálótanúsítvány érvényesítéséhez.
SslProtocols	Lekéri vagy beállítja a HttpClientHandler objektum által felügyelt objektumok által HttpClient használt TLS/SSL protokollokat.
SupportsAutomaticDecompression	Olyan értéket kap, amely jelzi, hogy a kezelő támogatja-e az automatikus választartalom-dekompressziót.
SupportsProxy	Olyan értéket kap, amely jelzi, hogy a kezelő támogatja-e a proxybeállításokat.
SupportsRedirectConfiguration	Olyan értéket kap, amely jelzi, hogy a kezelő támogatja-e a konfigurációs beállításokat és AllowAutoRedirect tulajdonságokatMaxAutomaticRedirections.
UseCookies	Lekéri vagy beállít egy értéket, amely jelzi, hogy a kezelő a CookieContainer tulajdonságot kiszolgálói cookie-k tárolására használja-e, és ezeket a cookie-kat használja-e a kérések küldésekor.
UseDefaultCredentials	Lekéri vagy beállít egy értéket, amely meghatározza, hogy az alapértelmezett hitelesítő adatokat a kezelő kéréseivel küldi-e el.
UseProxy	Lekéri vagy beállít egy értéket, amely jelzi, hogy a kezelő proxyt használ-e a kérésekhez.

Metódusok

Name	Description
Dispose()	Felszabadítja a nem felügyelt erőforrásokat, és a felügyelt erőforrásokat HttpMessageHandlera . (Öröklődés forrása HttpMessageHandler)
Dispose(Boolean)	Felszabadítja a felügyelt erőforrások által HttpClientHandler használt nem felügyelt erőforrásokat, és opcionálisan megsemmisíti a felügyelt erőforrásokat.
Equals(Object)	Meghatározza, hogy a megadott objektum egyenlő-e az aktuális objektummal. (Öröklődés forrása Object)
GetHashCode()	Ez az alapértelmezett kivonatoló függvény. (Öröklődés forrása Object)
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
Send(HttpRequestMessage, CancellationToken)	Létrehoz egy példányt HttpResponseMessage a megadott információk alapján.HttpRequestMessage
SendAsync(HttpRequestMessage, CancellationToken)	Létrehoz egy példányt HttpResponseMessage a műveletben HttpRequestMessage megadott információk alapján, amely nem tiltható le.
ToString()	Az aktuális objektumot jelképező sztringet ad vissza. (Öröklődés forrása Object)

Lásd még

• Csatlakozás webszolgáltatáshoz
• Rövid útmutató: Csatlakozás a HttpClient használatával
• HttpClient-kezelők használata
• HttpClient-kapcsolatok védelme