HttpClientHandler Klas

Definitie

Naamruimte:
System.Net.Http
Assembly:
System.Net.Http.dll
Assembly:
netstandard.dll

De standaardberichthandler die wordt gebruikt door HttpClient in .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
Overname
Object
HttpMessageHandler
HttpClientHandler
Afgeleid

Voorbeelden

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

Opmerkingen

Zie Aanvullende API-opmerkingen voor HttpClientHandler voor meer informatie over deze API.

Constructors

Name Description
HttpClientHandler()

Hiermee maakt u een exemplaar van een HttpClientHandler klasse.

Eigenschappen

Name Description
AllowAutoRedirect

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de handler omleidingsreacties moet volgen.
AutomaticDecompression

Hiermee haalt u het type decompressiemethode op dat door de handler wordt gebruikt voor automatische decompressie van het HTTP-inhoudsantwoord.
CheckCertificateRevocationList

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het certificaat is gecontroleerd op basis van de intrekkingslijst van de certificeringsinstantie.
ClientCertificateOptions

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het certificaat automatisch wordt gekozen uit het certificaatarchief of als de aanroeper een specifiek clientcertificaat mag doorgeven.
ClientCertificates

Hiermee haalt u de verzameling beveiligingscertificaten op die zijn gekoppeld aan aanvragen voor de server.
CookieContainer

Hiermee haalt u de cookiecontainer op die wordt gebruikt voor het opslaan van servercookies door de handler.
Credentials

Hiermee haalt u verificatiegegevens op die door deze handler worden gebruikt of stelt u deze in.
DangerousAcceptAnyServerCertificateValidator

Hiermee wordt een gedelegeerde in de cache opgehaald die altijd wordt geretourneerd true.
DefaultProxyCredentials

Wanneer de standaardproxy (systeemproxy) wordt gebruikt, haalt of stelt u de referenties in die moeten worden verzonden naar de standaardproxyserver voor verificatie. De standaardproxy wordt alleen gebruikt wanneer UseProxy deze is ingesteld true op en Proxy is ingesteld op null.
MaxAutomaticRedirections

Hiermee haalt of stelt u het maximum aantal omleidingen op dat door de handler wordt gevolgd.
MaxConnectionsPerServer

Hiermee wordt het maximum aantal gelijktijdige verbindingen (per servereindpunt) opgehaald of ingesteld dat is toegestaan bij het indienen van aanvragen met behulp van een HttpClient object. Houd er rekening mee dat de limiet per servereindpunt is, dus een waarde van 256 zou 256 gelijktijdige verbindingen met http://www.adatum.com/ en een andere 256 to http://www.adventure-works.com/toestaan.
MaxRequestContentBufferSize

Hiermee haalt u de maximale grootte van de aanvraaginhoudsbuffer op die door de handler wordt gebruikt.
MaxResponseHeadersLength

Hiermee haalt u de maximale lengte op, in kilobytes (1024 bytes), van de antwoordheaders. Als de waarde bijvoorbeeld 64 is, zijn 65536 bytes toegestaan voor de maximale lengte van antwoordheaders.
PreAuthenticate

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de handler een autorisatieheader met de aanvraag verzendt.
Properties

Hiermee haalt u een schrijfbare woordenlijst (dat wil gezegd een kaart) van aangepaste eigenschappen voor de HttpClient aanvragen op. De woordenlijst is leeg. u kunt sleutel-waardeparen invoegen en opvragen voor uw aangepaste handlers en speciale verwerking.
Proxy

Hiermee worden proxygegevens opgehaald of ingesteld die door de handler worden gebruikt.
ServerCertificateCustomValidationCallback

Hiermee haalt u een callbackmethode op of stelt u deze in om het servercertificaat te valideren.
SslProtocols

Hiermee worden de TLS/SSL-protocollen opgehaald of ingesteld die worden gebruikt door de HttpClient objecten die worden beheerd door het HttpClientHandler-object.
SupportsAutomaticDecompression

Hiermee wordt een waarde opgehaald die aangeeft of de handler automatische antwoordinhoudsdecompressie ondersteunt.
SupportsProxy

Hiermee wordt een waarde opgehaald die aangeeft of de handler proxy-instellingen ondersteunt.
SupportsRedirectConfiguration

Hiermee wordt een waarde opgehaald die aangeeft of de handler configuratie-instellingen voor de AllowAutoRedirect en MaxAutomaticRedirections eigenschappen ondersteunt.
UseCookies

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de handler gebruikmaakt van de eigenschap voor het CookieContainer opslaan van servercookies en deze cookies gebruikt bij het verzenden van aanvragen.
UseDefaultCredentials

Hiermee wordt een waarde opgehaald of ingesteld waarmee wordt bepaald of standaardreferenties worden verzonden met aanvragen door de handler.
UseProxy

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of de handler een proxy gebruikt voor aanvragen.

Methoden

Name Description
Dispose()

Publiceert de onbeheerde resources en verwijdert de beheerde resources die door de HttpMessageHandler.

(Overgenomen van HttpMessageHandler)
Dispose(Boolean)

Publiceert de niet-beheerde resources die worden gebruikt door de HttpClientHandler beheerde resources en verwijdert desgewenst de beheerde resources.
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
SendAsync(HttpRequestMessage, CancellationToken)

Hiermee maakt u een exemplaar van op basis van HttpResponseMessage de informatie in de HttpRequestMessage als een bewerking die niet wordt geblokkeerd.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook