Поделиться через


HttpBaseProtocolFilter Класс

Определение

Базовый фильтр протокола для экземпляра 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
Наследование
Object Platform::Object IInspectable HttpBaseProtocolFilter
Атрибуты
Реализации

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Класс HttpBaseProtocolFilter предоставляет базовый фильтр или обработчик, используемый экземпляром HttpClient . Если в экземпляр HttpClient не добавляются дополнительные фильтры, единственным фильтром будет объект HttpBaseProtocolFilter.

Класс HttpBaseProtocolFilter предоставляет набор свойств для переключения различных низкоуровневых стеков HTTP.

Дополнительные фильтры, основанные на интерфейсе IHttpFilter , можно добавить в цепочку фильтров, применяемую к экземпляру HttpClient , которая может дополнительно обрабатывать или обрабатывать результаты объекта HttpBaseProtocolFilter.

Объект HttpBaseProtocolFilter создает исключения при отправке HTTP-запросов или получении ответов, а также возникают сбои сети (например, потеря подключения в режиме "в самолете"). Разработчики, использующие HttpClient в приложениях, могут предпочесть добавить фильтр, чтобы перехватывать эти исключения и преобразовывать их в коды ответов HTTP.

Журнал версий

Версия Windows Версия пакета SDK Добавленная стоимость
1511 10586 CookieUsageBehavior
1607 14393 ClearAuthenticationCache
1607 14393 ServerCustomValidationRequested
1903 18362 CreateForUser
1903 18362 Пользователь

Конструкторы

HttpBaseProtocolFilter()

Инициализирует новый экземпляр класса HttpBaseProtocolFilter .

В классическом приложении перед использованием экземпляра этого класса таким образом, чтобы отображать пользовательский интерфейс, необходимо связать объект с дескриптором окна владельца. Дополнительные сведения и примеры кода см. в статье Отображение объектов пользовательского интерфейса WinRT, зависящих от CoreWindow.

Свойства

AllowAutoRedirect

Возвращает или задает значение, указывающее, должен ли httpBaseProtocolFilter следовать ответам перенаправления.

AllowUI

Возвращает или задает значение, указывающее, может ли httpBaseProtocolFilter запрашивать учетные данные пользователя при запросе сервера.

AutomaticDecompression

Возвращает или задает значение, указывающее, может ли HttpBaseProtocolFilter автоматически распаковать ответ http-содержимого.

CacheControl

Возвращает или задает поведение элемента управления кэшем чтения и записи, которое будет использоваться в объекте HttpBaseProtocolFilter .

ClientCertificate

Получите или задайте SSL-сертификат клиента, который будет отправлен на сервер, если сервер запрашивает сертификат клиента.

CookieManager

Получите HttpCookieManager с файлами cookie, связанными с приложением.

CookieUsageBehavior

Возвращает или задает поведение использования файлов cookie. По умолчанию файлы cookie обрабатываются автоматически.

IgnorableServerCertificateErrors

Получение вектора ошибок SSL-сертификата сервера, которые приложение может впоследствии игнорировать.

MaxConnectionsPerServer

Возвращает или задает максимальное число TCP-подключений, разрешенных для каждого HTTP-сервера объектом HttpBaseProtocolFilter .

MaxVersion

Возвращает или задает версию используемого протокола HTTP.

ProxyCredential

Получите или задайте учетные данные, которые будут использоваться для согласования с прокси-сервером HTTP.

ServerCredential

Получите или задайте учетные данные, используемые для проверки подлинности на HTTP-сервере.

UseProxy

Возвращает или задает значение, указывающее, может ли HttpBaseProtocolFilter использовать прокси-сервер для отправки HTTP-запросов.

User

Возвращает пользователя , связанного с HttpBaseProtocolFilter.

Методы

ClearAuthenticationCache()

Удаляет учетные данные проверки подлинности, которые в настоящее время кэшируются на устройстве.

Close()

Закрывает экземпляр HttpBaseProtocolFilter и освобождает выделенные ресурсы.

CreateForUser(User)

Создает новый httpBaseProtocolFilter для определенного пользователя.

Dispose()

Выполняет определяемые приложением задачи, связанные с удалением, высвобождением или сбросом неуправляемых ресурсов.

SendRequestAsync(HttpRequestMessage)

Отправка HTTP-запроса с помощью HttpBaseProtocolFilter в качестве асинхронной операции.

События

ServerCustomValidationRequested

Это событие возникает при установке ssl/TLS-соединения с сервером. Следует реализовать обработчик событий для этого события, если необходимо выполнить дополнительную проверку (в дополнение к ОС по умолчанию) SSL-сертификата сервера.

Применяется к

См. также раздел