HttpBaseProtocolFilter Klasse

Definition

Namespace:

Windows.Web.Http.Filters

Der Basisprotokollfilter für einen HttpClient-instance.

public ref class HttpBaseProtocolFilter sealed : IClosable, IHttpFilter

/// [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.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, IHttpFilter

Vererbung

Object Platform::Object IInspectable HttpBaseProtocolFilter

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Implementiert

IClosable IDisposable IHttpFilter

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Die HttpBaseProtocolFilter-Klasse stellt den Basisfilter oder -Handler bereit, der von einem HttpClient-instance verwendet wird. Wenn dem HttpClient-instance keine zusätzlichen Filter hinzugefügt werden, ist das HttpBaseProtocolFilter-Objekt der einzige Filter.

Die HttpBaseProtocolFilter-Klasse stellt eine Reihe von Eigenschaften zum Umschalten verschiedener HTTP-Stapelverhalten auf niedriger Ebene bereit.

Zusätzliche Filter, die auf der IHttpFilter-Schnittstelle basieren, können der Filterkette hinzugefügt werden, die auf einen HttpClient-instance angewendet wird, der die Ergebnisse des HttpBaseProtocolFilter-Objekts weiter verarbeiten oder verarbeiten kann.

Das HttpBaseProtocolFilter-Objekt löst Ausnahmen aus, wenn HTTP-Anforderungen gesendet oder antwortet und Netzwerkfehler auftreten (z. B. Konnektivitätsverlust im Flugzeugmodus). Entwickler, die HttpClient in Apps verwenden, ziehen es möglicherweise vor, einen Filter hinzuzufügen, um diese Ausnahmen abzufangen und stattdessen in HTTP-Antwortcodes zu konvertieren.

Versionsverlauf

Windows-Version	SDK-Version	Mehrwert
1511	10586	CookieUsageBehavior
1607	14393	ClearAuthenticationCache
1607	14393	ServerCustomValidationRequested
1903	18362	CreateForUser
1903	18362	User

Konstruktoren

HttpBaseProtocolFilter()

Initialisiert eine neue instance der HttpBaseProtocolFilter-Klasse. Bevor Sie in einer Desktop-App eine instance dieser Klasse so verwenden, dass die Benutzeroberfläche angezeigt wird, müssen Sie das Objekt dem Fensterhandle des Besitzers zuordnen. Weitere Informationen und Codebeispiele finden Sie unter Anzeigen von WinRT-UI-Objekten, die von CoreWindow abhängen.

Eigenschaften

AllowAutoRedirect	Rufen Sie einen Wert ab, der angibt, ob httpBaseProtocolFilter auf Umleitungsantworten folgen soll, oder legen Sie diesen fest.
AllowUI	Rufen Sie einen Wert ab, der angibt, ob httpBaseProtocolFilter bei Anforderung vom Server zur Eingabe von Benutzeranmeldeinformationen aufgefordert werden kann, oder legen Sie diesen fest.
AutomaticDecompression	Ruft einen Wert ab, der angibt, ob httpBaseProtocolFilter die HTTP-Inhaltsantwort automatisch dekomprimieren kann, oder legt diesen fest.
CacheControl	Rufen Sie das Lese- und Schreib-Cachesteuerungsverhalten ab, das für das HttpBaseProtocolFilter-Objekt verwendet werden soll, oder legen Sie es fest.
ClientCertificate	Rufen Sie das CLIENT-SSL-Zertifikat ab, das an den Server gesendet wird, wenn der Server ein Clientzertifikat anfordert, oder legen Sie es fest.
CookieManager	Rufen Sie den HttpCookieManager mit den Cookies ab, die einer App zugeordnet sind.
CookieUsageBehavior	Ruft das Cookienutzungsverhalten ab oder legt es fest. Cookies werden standardmäßig automatisch verarbeitet.
IgnorableServerCertificateErrors	Rufen Sie einen Vektor von SSL-Serverzertifikatfehlern ab, die die App später möglicherweise ignoriert.
MaxConnectionsPerServer	Rufen Sie die maximale Anzahl von TCP-Verbindungen ab, die pro HTTP-Server durch das HttpBaseProtocolFilter-Objekt zulässig sind, oder legen Sie diese fest.
MaxVersion	Ruft die Version des verwendeten HTTP-Protokolls ab oder legt diese fest.
ProxyCredential	Rufen Sie die Anmeldeinformationen ab, die zum Aushandeln mit einem HTTP-Proxy verwendet werden sollen, oder legen Sie sie fest.
ServerCredential	Rufen Sie die Anmeldeinformationen ab, die für die Authentifizierung bei einem HTTP-Server verwendet werden sollen, oder legen Sie sie fest.
UseProxy	Rufen Sie einen Wert ab, der angibt, ob httpBaseProtocolFilter einen Proxy zum Senden von HTTP-Anforderungen verwenden kann, oder legen Sie diesen fest.
User	Ruft den Benutzer ab, der dem HttpBaseProtocolFilter zugeordnet ist.

Methoden

ClearAuthenticationCache()	Löscht Authentifizierungsanmeldeinformationen, die derzeit auf dem Gerät zwischengespeichert sind.
Close()	Schließt die httpBaseProtocolFilter-instance und gibt zugeordnete Ressourcen frei.
CreateForUser(User)	Erstellt einen neuen HttpBaseProtocolFilter für einen bestimmten Benutzer.
Dispose()	Führt anwendungsspezifische Aufgaben durch, die mit der Freigabe, der Zurückgabe oder dem Zurücksetzen von nicht verwalteten Ressourcen zusammenhängen.
SendRequestAsync(HttpRequestMessage)	Senden Sie eine HTTP-Anforderung mithilfe von HttpBaseProtocolFilter als asynchronen Vorgang.

Ereignisse

ServerCustomValidationRequested

Dieses Ereignis wird ausgelöst, wenn die SSL/TLS-Verbindung mit dem Server hergestellt wird. Sie sollten einen Ereignishandler für dieses Ereignis implementieren, wenn Sie eine zusätzliche Validierung (zusätzlich zum Betriebssystemstandard) des SERVER-SSL-Zertifikats durchführen müssen.

Weitere Informationen

• IClosable
• IHttpFilter