Windows.Web.Http.Filters.HttpBaseProtocolFilter

May 17, 2019 ยท View on GitHub

-description

The base protocol filter for an HttpClient instance.

-remarks

The HttpBaseProtocolFilter class provides the base filter or handler that is used by an HttpClient instance. If no additional filters are added to the HttpClient instance, then the HttpBaseProtocolFilter object will be the only filter.

The HttpBaseProtocolFilter class provides a set of properties for toggling various low-level HTTP stack behaviors.

Additional filters based on the IHttpFilter interface can be added to the filter chain applied to an HttpClient instance that can further handle or process the results from the HttpBaseProtocolFilter object.

The HttpBaseProtocolFilter object throws exceptions when sending HTTP requests or receiving response and network failures occur (loss of connectivity in airplane mode, for example). Developers using HttpClient in apps may prefer to add a filter to catch these exceptions and convert them to HTTP response codes instead.

Version history

Windows versionSDK versionValue added
151110586CookieUsageBehavior
160714393ClearAuthenticationCache
160714393ServerCustomValidationRequested
190318362CreateForUser
190318362User

-examples

-see-also

IClosable, IHttpFilter