HttpBaseProtocolFilter Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Базовый фильтр протокола для экземпляра HttpClient .
public ref class HttpBaseProtocolFilter sealed : IClosablepublic 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, IHttpFilterfunction HttpBaseProtocolFilter()Public NotInheritable Class HttpBaseProtocolFilter
Implements IDisposablePublic NotInheritable Class HttpBaseProtocolFilter
Implements 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-сертификата сервера. |