Freigeben über


HttpBaseProtocolFilter Klasse

Definition

Der Basisprotokollfilter für einen HttpClient-instance.

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
Vererbung
Object Platform::Object IInspectable HttpBaseProtocolFilter
Attribute
Implementiert

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.

Gilt für:

Weitere Informationen