DelegatingHandler Class

Definition

A type for HTTP handlers that delegate the processing of HTTP response messages to another handler, called the inner handler.

public abstract class DelegatingHandler : System.Net.Http.HttpMessageHandler
Inheritance
DelegatingHandler
Derived

Remarks

An application should provide an inner handler either in the constructor or through the InnerHandler property before calling SendAsync; otherwise, an InvalidOperationException will be thrown.

Note that InnerHandler property may be a delegating handler as well. This approach allows the creation of handler stacks to process the HTTP response messages.

Constructors

DelegatingHandler()

Creates a new instance of the DelegatingHandler class.

DelegatingHandler(HttpMessageHandler)

Creates a new instance of the DelegatingHandler class with a specific inner handler.

Properties

InnerHandler

Gets or sets the inner handler which processes the HTTP response messages.

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 DelegatingHandler, and optionally disposes of the managed resources.

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)

Sends an HTTP request to the inner handler to send to the server.

Send(HttpRequestMessage, CancellationToken)

When overridden in a derived class, sends an HTTP request with the specified request and cancellation token. Otherwise, throws a NotSupportedException.

(Inherited from HttpMessageHandler)
SendAsync(HttpRequestMessage, CancellationToken)

Sends an HTTP request to the inner handler to send to the server as an asynchronous operation.

ToString()

Returns a string that represents the current object.

(Inherited from Object)

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0