Condividi tramite


HttpBaseProtocolFilter Classe

Definizione

Filtro del protocollo di base per un'istanza HttpClient .

public ref class HttpBaseProtocolFilter sealed : IClosable
public ref class HttpBaseProtocolFilter sealed : IClosable, IHttpFilter
/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class HttpBaseProtocolFilter final : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpBaseProtocolFilter final : IClosable
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class HttpBaseProtocolFilter final : IClosable, IHttpFilter
[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class HttpBaseProtocolFilter : System.IDisposable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpBaseProtocolFilter : System.IDisposable
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class HttpBaseProtocolFilter : System.IDisposable, IHttpFilter
function HttpBaseProtocolFilter()
Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposable
Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposable, IHttpFilter
Ereditarietà
Object Platform::Object IInspectable HttpBaseProtocolFilter
Attributi
Implementazioni

Requisiti Windows

Famiglia di dispositivi
Windows 10 (è stato introdotto in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (è stato introdotto in v1.0)

Commenti

La classe HttpBaseProtocolFilter fornisce il filtro di base o il gestore utilizzato da un'istanza HttpClient . Se all'istanza di HttpClient non vengono aggiunti filtri aggiuntivi, l'oggetto HttpBaseProtocolFilter sarà l'unico filtro.

La classe HttpBaseProtocolFilter fornisce un set di proprietà per attivare o disattivare i diversi comportamenti dello stack HTTP di basso livello.

È possibile aggiungere filtri aggiuntivi basati sull'interfaccia IHttpFilter alla catena di filtri applicata a un'istanza httpClient in grado di gestire o elaborare ulteriormente i risultati dall'oggetto HttpBaseProtocolFilter.

L'oggetto HttpBaseProtocolFilter genera eccezioni durante l'invio di richieste HTTP o la ricezione di errori di risposta e di rete ,ad esempio la perdita di connettività in modalità aereo. Gli sviluppatori che usano HttpClient nelle app potrebbero preferire aggiungere un filtro per intercettare queste eccezioni e convertirle in codici di risposta HTTP.

Cronologia delle versioni

Versione di Windows Versione dell'SDK Valore aggiunto
1511 10586 CookieUsageBehavior
1607 14393 ClearAuthenticationCache
1607 14393 ServerCustomValidationRequested
1903 18362 CreateForUser
1903 18362 Utente

Costruttori

HttpBaseProtocolFilter()

Inizializza una nuova istanza della classe HttpBaseProtocolFilter .

In un'app desktop, prima di usare un'istanza di questa classe in modo da visualizzare l'interfaccia utente, dovrai associare l'oggetto all'handle della finestra del proprietario. Per altre info ed esempi di codice, vedi Visualizzare gli oggetti dell'interfaccia utente WinRT che dipendono da CoreWindow.

Proprietà

AllowAutoRedirect

Ottiene o imposta un valore che indica se HttpBaseProtocolFilter deve seguire le risposte di reindirizzamento.

AllowUI

Ottiene o imposta un valore che indica se HttpBaseProtocolFilter può richiedere le credenziali utente quando richiesto dal server.

AutomaticDecompression

Ottiene o imposta un valore che indica se HttpBaseProtocolFilter può decomprimere automaticamente la risposta al contenuto HTTP.

CacheControl

Ottiene o imposta il comportamento del controllo cache di lettura e scrittura da utilizzare nell'oggetto HttpBaseProtocolFilter .

ClientCertificate

Ottiene o imposta il certificato SSL client che verrà inviato al server se il server richiede un certificato client.

CookieManager

Ottenere HttpCookieManager con i cookie associati a un'app.

CookieUsageBehavior

Ottiene o imposta il comportamento di utilizzo dei cookie. Per impostazione predefinita, i cookie vengono gestiti automaticamente.

IgnorableServerCertificateErrors

Ottenere un vettore di errori del certificato server SSL che l'app potrebbe successivamente scegliere di ignorare.

MaxConnectionsPerServer

Ottiene o imposta il numero massimo di connessioni TCP consentite per ogni server HTTP dall'oggetto HttpBaseProtocolFilter .

MaxVersion

Ottiene o imposta la versione del protocollo HTTP utilizzata.

ProxyCredential

Ottenere o impostare le credenziali da usare per negoziare con un proxy HTTP.

ServerCredential

Ottenere o impostare le credenziali da usare per l'autenticazione con un server HTTP.

UseProxy

Ottiene o imposta un valore che indica se HttpBaseProtocolFilter può usare un proxy per l'invio di richieste HTTP.

User

Ottiene l'oggetto User associato a HttpBaseProtocolFilter.

Metodi

ClearAuthenticationCache()

Cancella le credenziali di autenticazione attualmente memorizzate nella cache nel dispositivo.

Close()

Chiude l'istanza httpBaseProtocolFilter e rilascia le risorse allocate.

CreateForUser(User)

Crea un nuovo HttpBaseProtocolFilter per un utente specifico.

Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

SendRequestAsync(HttpRequestMessage)

Inviare una richiesta HTTP usando HttpBaseProtocolFilter come operazione asincrona.

Eventi

ServerCustomValidationRequested

Questo evento viene generato quando viene stabilita la connessione SSL/TLS con il server. È necessario implementare un gestore eventi per questo evento se è necessario eseguire una convalida aggiuntiva (oltre all'impostazione predefinita del sistema operativo) del certificato SSL del server.

Si applica a

Vedi anche