HttpBaseProtocolFilter Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.Web.Http.Filters

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementazioni: IClosable IDisposable IHttpFilter

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

Condividi tramite