WebRequestHandler Class

Definition

Provides desktop-specific features not available to Windows Store apps or other environments.

public ref class WebRequestHandler : System::Net::Http::HttpClientHandler
public class WebRequestHandler : System.Net.Http.HttpClientHandler
type WebRequestHandler = class
    inherit HttpClientHandler
Public Class WebRequestHandler
Inherits HttpClientHandler
Inheritance

Remarks

This class implements a transport handler using HttpWebRequest instances to send HTTP requests to servers.

Constructors

WebRequestHandler()

Initializes a new instance of the WebRequestHandler class.

Properties

AllowAutoRedirect

Gets or sets a value that indicates whether the handler should follow redirection responses.

(Inherited from HttpClientHandler)
AllowPipelining

Gets or sets a value that indicates whether to pipeline the request to the Internet resource.

AuthenticationLevel

Gets or sets a value indicating the level of authentication and impersonation used for this request.

AutomaticDecompression

Gets or sets the type of decompression method used by the handler for automatic decompression of the HTTP content response.

(Inherited from HttpClientHandler)
CachePolicy

Gets or sets the cache policy for this request.

CheckCertificateRevocationList

Gets or sets a value that indicates whether the certificate is checked against the certificate authority revocation list.

(Inherited from HttpClientHandler)
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.

(Inherited from HttpClientHandler)
ClientCertificates

Gets or sets the collection of security certificates that are associated with this request.

ContinueTimeout

Gets or sets the amount of time, in milliseconds, the application will wait for 100-continue from the server before uploading data.

CookieContainer

Gets or sets the cookie container used to store server cookies by the handler.

(Inherited from HttpClientHandler)
Credentials

Gets or sets authentication information used by this handler.

(Inherited from HttpClientHandler)
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 UseProxy is set to true and Proxy is set to null.

(Inherited from HttpClientHandler)
ImpersonationLevel

Gets or sets the impersonation level for the current request.

MaxAutomaticRedirections

Gets or sets the maximum number of redirects that the handler follows.

(Inherited from HttpClientHandler)
MaxConnectionsPerServer

Gets or sets the maximum number of concurrent connections (per server endpoint) allowed when making requests using an 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/.

(Inherited from HttpClientHandler)
MaxRequestContentBufferSize

Gets or sets the maximum request content buffer size used by the handler.

(Inherited from HttpClientHandler)
MaxResponseHeadersLength

Gets or sets the maximum allowed length of the response headers.

MeterFactory

Gets or sets the IMeterFactory to create a custom Meter for the HttpClientHandler instance.

(Inherited from HttpClientHandler)
PreAuthenticate

Gets or sets a value that indicates whether the handler sends an Authorization header with the request.

(Inherited from HttpClientHandler)
Properties

Gets a writable dictionary (that is, a map) of custom properties for the HttpClient requests. The dictionary is initialized empty; you can insert and query key-value pairs for your custom handlers and special processing.

(Inherited from HttpClientHandler)
Proxy

Gets or sets proxy information used by the handler.

(Inherited from HttpClientHandler)
ReadWriteTimeout

Gets or sets a time-out in milliseconds when writing a request to or reading a response from a server.

ServerCertificateCustomValidationCallback

Gets or sets a callback method to validate the server certificate.

(Inherited from HttpClientHandler)
ServerCertificateValidationCallback

Gets or sets a callback method to validate the server certificate.

SslProtocols

Gets or sets the TLS/SSL protocol used by the HttpClient objects managed by the HttpClientHandler object.

(Inherited from HttpClientHandler)
SupportsAutomaticDecompression

Gets a value that indicates whether the handler supports automatic response content decompression.

(Inherited from HttpClientHandler)
SupportsProxy

Gets a value that indicates whether the handler supports proxy settings.

(Inherited from HttpClientHandler)
SupportsRedirectConfiguration

Gets a value that indicates whether the handler supports configuration settings for the AllowAutoRedirect and MaxAutomaticRedirections properties.

(Inherited from HttpClientHandler)
UnsafeAuthenticatedConnectionSharing

Gets or sets a value that indicates whether to allow high-speed NTLM-authenticated connection sharing.

UseCookies

Gets or sets a value that indicates whether the handler uses the CookieContainer property to store server cookies and uses these cookies when sending requests.

(Inherited from HttpClientHandler)
UseDefaultCredentials

Gets or sets a value that controls whether default credentials are sent with requests by the handler.

(Inherited from HttpClientHandler)
UseProxy

Gets or sets a value that indicates whether the handler uses a proxy for requests.

(Inherited from HttpClientHandler)

Methods

Dispose()

Releases the unmanaged resources and disposes of the managed resources used by the HttpMessageHandler.

(Inherited from HttpMessageHandler)
Dispose(Boolean)

Releases the unmanaged resources used by the HttpClientHandler and optionally disposes of the managed resources.

(Inherited from HttpClientHandler)
Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetType()

Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
Send(HttpRequestMessage, CancellationToken)

Creates an instance of HttpResponseMessage based on the information provided in the HttpRequestMessage.

(Inherited from HttpClientHandler)
SendAsync(HttpRequestMessage, CancellationToken)

Creates an instance of HttpResponseMessage based on the information provided in the HttpRequestMessage as an operation that will not block.

(Inherited from HttpClientHandler)
ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to