HttpMessageHandler クラス

定義

名前空間:

System.Net.Http

アセンブリ:

netstandard.dll, System.Net.Http.dll

ソース:

HttpMessageHandler.cs

HTTP メッセージ ハンドラーの基本型。

public ref class HttpMessageHandler abstract : IDisposable

public abstract class HttpMessageHandler : IDisposable

type HttpMessageHandler = class
    interface IDisposable

Public MustInherit Class HttpMessageHandler
Implements IDisposable

継承

Object

HttpMessageHandler

派生

System.Net.Http.DelegatingHandler

System.Net.Http.HttpClientHandler

System.Net.Http.SocketsHttpHandler

System.Net.Http.WinHttpHandler

実装

IDisposable

注釈

使用できるさまざまな HTTP メッセージ ハンドラーがあります。 これには、次のようなものがあります。

1. DelegatingHandler - ハンドラーをハンドラー チェーンにプラグインするために使用されるクラス。

2. HttpMessageHandler - そこから派生する単純なクラスは、ほとんどのアプリケーションで最も一般的な要件をサポートします。

3. HttpClientHandler - HTTP トランスポート操作を実際に処理するハンドラー チェーンの下部で動作するクラス。

4. WebRequestHandler - System.Net.HttpWebRequest オブジェクトに固有のオプションを使用して HTTP トランスポート操作を処理するハンドラー チェーン クラスの下部で動作する特殊なクラス。

開発者が HttpMessageHandler からクラスを派生させ、 SendAsync メソッドをオーバーライドする場合は、 SendAsync が異なるスレッドによって同時に呼び出されることを確認する必要があります。

これは、 HttpClient のメソッドを同時に呼び出すことができるため、スレッド の安全性を保証する必要があるために必要です。 そのため、ハンドラーが HttpClient インスタンスに割り当てられている場合、ハンドラーの SendAsync メソッドは、 HttpClient インスタンスによって同時に呼び出される可能性があり、スレッド セーフである必要があります。

コンストラクター

名前	説明
HttpMessageHandler()	HttpMessageHandler クラスの新しいインスタンスを初期化します。

メソッド

名前	説明
Dispose()	アンマネージ リソースを解放し、 HttpMessageHandlerによって使用されるマネージド リソースを破棄します。
Dispose(Boolean)	HttpMessageHandlerによって使用されるアンマネージ リソースを解放し、必要に応じてマネージド リソースを破棄します。
Equals(Object)	指定したオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Objectの簡易コピーを作成します。 (継承元 Object)
Send(HttpRequestMessage, CancellationToken)	派生クラスでオーバーライドされると、指定された要求とキャンセル トークンを使用して HTTP 要求を送信します。 それ以外の場合は、 NotSupportedExceptionをスローします。
SendAsync(HttpRequestMessage, CancellationToken)	HTTP 要求を非同期操作として送信します。
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)