HttpClientHandler Classe

Definizione

Il gestore di messaggi predefinito usato da HttpClient.NET Framework e .NET Core 2.0 e versioni precedenti.

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à
HttpClientHandler
Derivato

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 la sezione Note supplementari sull'API per HttpClientHandler.

Costruttori

HttpClientHandler()

Crea un'istanza di una classe HttpClientHandler.

Proprietà

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 usato dal gestore per la decompressione automatica della risposta del contenuto HTTP.

CheckCertificateRevocationList

Ottiene o imposta un valore che indica se il certificato viene verificato 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 oppure se il chiamante è autorizzato a 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 usato dal gestore per archiviare i cookie del server.

Credentials

Ottiene o imposta le informazioni sull'autenticazione usate dal gestore.

DangerousAcceptAnyServerCertificateValidator

Ottiene un delegato memorizzato nella cache che restituisce sempre true.

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 l'elemento UseProxy è impostato su true e l'elemento Proxy è impostato su null.

MaxAutomaticRedirections

Ottiene o imposta il numero massimo di reindirizzamenti seguiti dal gestore.

MaxConnectionsPerServer

Ottiene o imposta il numero massimo di connessioni simultanee (per endpoint server) consentito quando si effettuano richieste tramite un oggetto HttpClient. Il limite è per ogni endpoint server. Ad esempio il valore 256 autorizza 256 connessioni simultanee a http://www.adatum.com/ e altre 256 connessioni simultanee a http://www.adventure-works.com/.

MaxRequestContentBufferSize

Ottiene o imposta la dimensione massima del buffer di contenuto della richiesta usata dal gestore.

MaxResponseHeadersLength

Ottiene o imposta la lunghezza massima in kilobyte (1024 byte) delle intestazioni di risposta. Se ad esempio il valore è 64 la lunghezza massima consentita per le intestazioni di risposta è pari a 65536 byte.

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 modificabile (una mappa) delle proprietà personalizzate per le richieste HttpClient. Il dizionario viene inizializzato vuoto. È possibile inserire e cercare coppie chiave-valore per i gestori personalizzati e l'elaborazione speciale.

Proxy

Ottiene o imposta le informazioni sul proxy usate dal gestore.

ServerCertificateCustomValidationCallback

Ottiene o imposta un metodo callback per convalidare il certificato del server.

SslProtocols

Ottiene o imposta il protocollo TLS/SSL usato dagli oggetti HttpClient 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 proprietà AllowAutoRedirect 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 sono inviate con le richieste dal gestore.

UseProxy

Ottiene o imposta un valore che indica se il gestore usa un proxy per le richieste.

Metodi

Dispose()

Rilascia le risorse non gestite ed elimina le risorse gestite utilizzate dall'oggetto 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 l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
Send(HttpRequestMessage, CancellationToken)

Crea un'istanza di HttpResponseMessage in base alle informazioni fornite in HttpRequestMessage.

Send(HttpRequestMessage, CancellationToken)

Quando viene eseguito l'override in una classe derivata, invia una richiesta HTTP con la richiesta e il token di annullamento specificati. in caso contrario, genera NotSupportedException.

(Ereditato da HttpMessageHandler)
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)

Si applica a

Vedi anche