Early Preview
This is currently very much a preview. Please feel free to try things out,
but don't be upset if anything is not yet working. Feedback is welcome over on our
GitHub Dicussions page.
class System.Net.Http.HttpClientHandler
Assembly: System.Net.Http
Inheritance: object → HttpMessageHandler → HttpClientHandler
Implemented Interfaces
- IDisposable Implemented by: HttpMessageHandler
The default message handler used by <see cref="T:System.Net.Http.HttpClient" /> in .NET Framework and .NET Core 2.0 and earlier.
Properties
public
bool
AllowAutoRedirect
Gets or sets a value that indicates whether the handler should follow redirection responses.
public
DecompressionMethods
AutomaticDecompression
Gets or sets the type of decompression method used by the handler for automatic decompression of the HTTP content response.
public
bool
CheckCertificateRevocationList
Gets or sets a value that indicates whether the certificate is checked against the certificate authority revocation list.
public
ClientCertificateOption
ClientCertificateOptions
Gets or sets a value that indicates if the certificate is automatically picked from the certificate store or if the caller is allowed to pass in a specific client certificate.
ClientCertificates
Gets the collection of security certificates that are associated with requests to the server.
public
CookieContainer
CookieContainer
Gets or sets the cookie container used to store server cookies by the handler.
public
ICredentials
Credentials
Gets or sets authentication information used by this handler.
public static
Func<HttpRequestMessage, Security.Cryptography.X509Certificates.X509Certificate2, Security.Cryptography.X509Certificates.X509Chain, Security.SslPolicyErrors, bool>
DangerousAcceptAnyServerCertificateValidator
Gets a cached delegate that always returns <see langword="true" /> .
public
ICredentials
DefaultProxyCredentials
When the default (system) proxy is being used, gets or sets the credentials to submit to the default proxy server for authentication. The default proxy is used only when <see cref="P:System.Net.Http.HttpClientHandler.UseProxy" /> is set to <see langword="true" /> and <see cref="P:System.Net.Http.HttpClientHandler.Proxy" /> is set to <see langword="null" /> .
public
int
MaxAutomaticRedirections
Gets or sets the maximum number of redirects that the handler follows.
public
int
MaxConnectionsPerServer
Gets or sets the maximum number of concurrent connections (per server endpoint) allowed when making requests using an <see cref="T:System.Net.Http.HttpClient" /> object. Note that the limit is per server endpoint, so for example a value of 256 would permit 256 concurrent connections to http://www.adatum.com/ and another 256 to http://www.adventure-works.com/.
public
long
MaxRequestContentBufferSize
Gets or sets the maximum request content buffer size used by the handler.
public
int
MaxResponseHeadersLength
Gets or sets the maximum length, in kilobytes (1024 bytes), of the response headers. For example, if the value is 64, then 65536 bytes are allowed for the maximum response headers' length.
MeterFactory
Gets or sets the <see cref="T:System.Diagnostics.Metrics.IMeterFactory" /> to create a custom <see cref="T:System.Diagnostics.Metrics.Meter" /> for the <see cref="T:System.Net.Http.HttpClientHandler" /> instance.
public
bool
PreAuthenticate
Gets or sets a value that indicates whether the handler sends an Authorization header with the request.
public
Collections.Generic.IDictionary<string, object>
Properties
Gets a writable dictionary (that is, a map) of custom properties for the <see cref="T:System.Net.Http.HttpClient" /> requests. The dictionary is initialized empty; you can insert and query key-value pairs for your custom handlers and special processing.
public
IWebProxy
Proxy
Gets or sets proxy information used by the handler.
public
Func<HttpRequestMessage, Security.Cryptography.X509Certificates.X509Certificate2, Security.Cryptography.X509Certificates.X509Chain, Security.SslPolicyErrors, bool>
ServerCertificateCustomValidationCallback
Gets or sets a callback method to validate the server certificate.
SslProtocols
Gets or sets the TLS/SSL protocols used by the <see cref="T:System.Net.Http.HttpClient" /> objects managed by the HttpClientHandler object.
public
bool
SupportsAutomaticDecompression
Gets a value that indicates whether the handler supports automatic response content decompression.
public
bool
SupportsProxy
Gets a value that indicates whether the handler supports proxy settings.
public
bool
SupportsRedirectConfiguration
Gets a value that indicates whether the handler supports configuration settings for the <see cref="P:System.Net.Http.HttpClientHandler.AllowAutoRedirect" /> and <see cref="P:System.Net.Http.HttpClientHandler.MaxAutomaticRedirections" /> properties.
public
bool
UseCookies
Gets or sets a value that indicates whether the handler uses the <see cref="P:System.Net.Http.HttpClientHandler.CookieContainer" /> property to store server cookies and uses these cookies when sending requests.
public
bool
UseDefaultCredentials
Gets or sets a value that controls whether default credentials are sent with requests by the handler.
public
bool
UseProxy
Gets or sets a value that indicates whether the handler uses a proxy for requests.
Methods
protected
void
Dispose(bool disposing)
Releases the unmanaged resources used by the <see cref="T:System.Net.Http.HttpClientHandler" /> and optionally disposes of the managed resources.
disposing
<see langword="true" /> to release both managed and unmanaged resources; <see langword="false" /> to releases only unmanaged resources.
public
void
Dispose()
Inherited from HttpMessageHandler
Releases the unmanaged resources and disposes of the managed resources used by the <see cref="T:System.Net.Http.HttpMessageHandler" /> .
public
bool
Equals(object obj)
Inherited from object
protected
void
Finalize()
Inherited from object
public
int
GetHashCode()
Inherited from object
protected
object
MemberwiseClone()
Inherited from object
public
string
ToString()
Inherited from object