This topic has not yet been rated - Rate this topic

WebRequestHandler Class

.NET Framework 4.5

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

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

System.Object
  System.Net.Http.HttpMessageHandler
    System.Net.Http.HttpClientHandler
      System.Net.Http.WebRequestHandler

Namespace:  System.Net.Http
Assembly:  System.Net.Http.WebRequest (in System.Net.Http.WebRequest.dll)

public class WebRequestHandler : HttpClientHandler

The WebRequestHandler type exposes the following members.

  Name Description
Public method WebRequestHandler Initializes a new instance of the WebRequestHandler class.
Top
  Name Description
Public property AllowAutoRedirect Gets or sets a value that indicates whether the handler should follow redirection responses. (Inherited from HttpClientHandler.)
Public property AllowPipelining Gets or sets a value that indicates whether to pipeline the request to the Internet resource.
Public property AuthenticationLevel Gets or sets a value indicating the level of authentication and impersonation used for this request.
Public property AutomaticDecompression Gets or sets the type of decompression method used by the handler for automatic decompression of the HTTP content response. (Inherited from HttpClientHandler.)
Public property CachePolicy Gets or sets the cache policy for this request.
Public property ClientCertificateOptions Gets or sets the collection of security certificates that are associated with this handler. (Inherited from HttpClientHandler.)
Public property ClientCertificates Gets or sets the collection of security certificates that are associated with this request.
Public property ContinueTimeout Gets or sets the amount of time, in milliseconds, the application will wait for 100-continue from the server before uploading data.
Public property CookieContainer Gets or sets the cookie container used to store server cookies by the handler. (Inherited from HttpClientHandler.)
Public property Credentials Gets or sets authentication information used by this handler. (Inherited from HttpClientHandler.)
Public property ImpersonationLevel Gets or sets the impersonation level for the current request.
Public property MaxAutomaticRedirections Gets or sets the maximum number of redirects that the handler follows. (Inherited from HttpClientHandler.)
Public property MaxRequestContentBufferSize Gets or sets the maximum request content buffer size used by the handler. (Inherited from HttpClientHandler.)
Public property MaxResponseHeadersLength Gets or sets the maximum allowed length of the response headers.
Public property PreAuthenticate Gets or sets a value that indicates whether the handler sends an Authorization header with the request. (Inherited from HttpClientHandler.)
Public property Proxy Gets or sets proxy information used by the handler. (Inherited from HttpClientHandler.)
Public property ReadWriteTimeout Gets or sets a time-out in milliseconds when writing a request to or reading a response from a server.
Public property ServerCertificateValidationCallback
Public property SupportsAutomaticDecompression Gets a value that indicates whether the handler supports automatic response content decompression. (Inherited from HttpClientHandler.)
Public property SupportsProxy Gets a value that indicates whether the handler supports proxy settings. (Inherited from HttpClientHandler.)
Public property SupportsRedirectConfiguration Gets a value that indicates whether the handler supports configuration settings for the AllowAutoRedirect and MaxAutomaticRedirections properties. (Inherited from HttpClientHandler.)
Public property UnsafeAuthenticatedConnectionSharing Gets or sets a value that indicates whether to allow high-speed NTLM-authenticated connection sharing.
Public property 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.)
Public property UseDefaultCredentials Gets or sets a value that controls whether default credentials are sent with requests by the handler. (Inherited from HttpClientHandler.)
Public property UseProxy Gets or sets a value that indicates whether the handler uses a proxy for requests. (Inherited from HttpClientHandler.)
Top
  Name Description
Public method Dispose() Releases the unmanaged resources and disposes of the managed resources used by the HttpMessageHandler. (Inherited from HttpMessageHandler.)
Protected method Dispose(Boolean) Releases the unmanaged resources used by the HttpClientHandler and optionally disposes of the managed resources. (Inherited from HttpClientHandler.)
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Protected method SendAsync Creates an instance of HttpResponseMessage based on the information provided in the HttpRequestMessage as an operation that will not block. (Inherited from HttpClientHandler.)
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Top

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

.NET Framework

Supported in: 4.5

Windows 8 Release Preview, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)