HttpBaseProtocolFilter Класс

Определение

Пространство имен:

Windows.Web.Http.Filters

Базовый фильтр протокола для экземпляра HttpClient .

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

Наследование

Object Platform::Object IInspectable HttpBaseProtocolFilter

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IClosable IDisposable IHttpFilter

Требования к 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-сертификата сервера.

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

• IClosable
• IHttpFilter