HttpClientHandler Classe

Definizione

Spazio dei nomi:

System.Net.Http

Assembly:

netstandard.dll, System.Net.Http.dll

Origine:

HttpClientHandler.cs

Gestore di messaggi predefinito usato da 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

Ereditarietà

Object

HttpMessageHandler

HttpClientHandler

Derivato

System.Net.Http.WebRequestHandler

Esempio

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

Commenti

Per altre informazioni su questa API, vedere Osservazioni supplementari sull'API per HttpClientHandler.

Costruttori

Nome	Descrizione
HttpClientHandler()	Crea un'istanza di una HttpClientHandler classe.

Proprietà

Nome	Descrizione
AllowAutoRedirect	Ottiene o imposta un valore che indica se il gestore deve seguire le risposte di reindirizzamento.
AutomaticDecompression	Ottiene o imposta il tipo di metodo di decompressione utilizzato dal gestore per la decompressione automatica della risposta al contenuto HTTP.
CheckCertificateRevocationList	Ottiene o imposta un valore che indica se il certificato viene controllato rispetto all'elenco di revoche dell'autorità di certificazione.
ClientCertificateOptions	Ottiene o imposta un valore che indica se il certificato viene selezionato automaticamente dall'archivio certificati o se il chiamante può passare un certificato client specifico.
ClientCertificates	Ottiene la raccolta di certificati di sicurezza associati alle richieste al server.
CookieContainer	Ottiene o imposta il contenitore di cookie utilizzato per archiviare i cookie del server dal gestore.
Credentials	Ottiene o imposta le informazioni di autenticazione utilizzate da questo gestore.
DangerousAcceptAnyServerCertificateValidator	Ottiene un delegato memorizzato nella cache che restituisce truesempre .
DefaultProxyCredentials	Quando viene usato il proxy predefinito (di sistema), ottiene o imposta le credenziali da inviare al server proxy predefinito per l'autenticazione. Il proxy predefinito viene usato solo quando UseProxy è impostato su true e Proxy è impostato su null.
MaxAutomaticRedirections	Ottiene o imposta il numero massimo di reindirizzamenti che segue il gestore.
MaxConnectionsPerServer	Ottiene o imposta il numero massimo di connessioni simultanee (per endpoint server) consentite durante l'esecuzione di richieste tramite un HttpClient oggetto . Si noti che il limite è per endpoint server, quindi, ad esempio, un valore pari a 256 consente 256 connessioni simultanee a http://www.adatum.com/ e un altro 256 a http://www.adventure-works.com/.
MaxRequestContentBufferSize	Ottiene o imposta la dimensione massima del buffer del contenuto della richiesta utilizzata dal gestore.
MaxResponseHeadersLength	Ottiene o imposta la lunghezza massima, espressa in kilobyte (1024 byte) delle intestazioni della risposta. Ad esempio, se il valore è 64, sono consentiti 65536 byte per la lunghezza massima delle intestazioni di risposta.
MeterFactory	Ottiene o imposta l'oggetto IMeterFactory per creare un oggetto personalizzato Meter per l'istanza HttpClientHandler di .
PreAuthenticate	Ottiene o imposta un valore che indica se il gestore invia un'intestazione di autorizzazione con la richiesta.
Properties	Ottiene un dizionario scrivibile , ovvero una mappa, di proprietà personalizzate per le HttpClient richieste. Il dizionario viene inizializzato vuoto; è possibile inserire ed eseguire query su coppie chiave-valore per i gestori personalizzati e l'elaborazione speciale.
Proxy	Ottiene o imposta le informazioni proxy utilizzate dal gestore.
ServerCertificateCustomValidationCallback	Ottiene o imposta un metodo di callback per convalidare il certificato del server.
SslProtocols	Ottiene o imposta i protocolli TLS/SSL utilizzati dagli HttpClient oggetti gestiti dall'oggetto HttpClientHandler.
SupportsAutomaticDecompression	Ottiene un valore che indica se il gestore supporta la decompressione automatica del contenuto della risposta.
SupportsProxy	Ottiene un valore che indica se il gestore supporta le impostazioni proxy.
SupportsRedirectConfiguration	Ottiene un valore che indica se il gestore supporta le impostazioni di configurazione per le AllowAutoRedirect proprietà e MaxAutomaticRedirections .
UseCookies	Ottiene o imposta un valore che indica se il gestore utilizza la CookieContainer proprietà per archiviare i cookie del server e usa questi cookie durante l'invio di richieste.
UseDefaultCredentials	Ottiene o imposta un valore che controlla se le credenziali predefinite vengono inviate con richieste dal gestore.
UseProxy	Ottiene o imposta un valore che indica se il gestore utilizza un proxy per le richieste.

Metodi

Nome	Descrizione
Dispose()	Rilascia le risorse non gestite ed elimina le risorse gestite usate da HttpMessageHandler. (Ereditato da HttpMessageHandler)
Dispose(Boolean)	Rilascia le risorse non gestite usate da HttpClientHandler e, facoltativamente, elimina le risorse gestite.
Equals(Object)	Determina se l'oggetto specificato è uguale all'oggetto corrente. (Ereditato da Object)
GetHashCode()	Funge da funzione hash predefinita. (Ereditato da Object)
GetType()	Ottiene il Type dell'istanza corrente. (Ereditato da Object)
MemberwiseClone()	Crea una copia superficiale del Objectcorrente. (Ereditato da Object)
Send(HttpRequestMessage, CancellationToken)	Crea un'istanza di HttpResponseMessage in base alle informazioni fornite in HttpRequestMessage.
SendAsync(HttpRequestMessage, CancellationToken)	Crea un'istanza di HttpResponseMessage in base alle informazioni fornite in HttpRequestMessage come operazione che non verrà bloccata.
ToString()	Restituisce una stringa che rappresenta l'oggetto corrente. (Ereditato da Object)

Vedi anche

• Connessione a un servizio Web
• Guida introduttiva: Connessione con HttpClient
• Come usare i gestori HttpClient
• Come proteggere le connessioni HttpClient