SocketsHttpHandler クラス
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
.NET Core 2.1 以降の HttpClient で使用される既定のメッセージ ハンドラーを提供します。
public ref class SocketsHttpHandler sealed : System::Net::Http::HttpMessageHandler
[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public sealed class SocketsHttpHandler : System.Net.Http.HttpMessageHandler
public sealed class SocketsHttpHandler : System.Net.Http.HttpMessageHandler
[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
type SocketsHttpHandler = class
inherit HttpMessageHandler
type SocketsHttpHandler = class
inherit HttpMessageHandler
Public NotInheritable Class SocketsHttpHandler
Inherits HttpMessageHandler
- 継承
- 属性
.NET Core 2.1 以降では、 SocketsHttpHandler
クラスは、 などの HttpClient上位レベルの HTTP ネットワーク クラスで使用される実装を提供します。 の SocketsHttpHandler
使用には、いくつかの利点があります。
以前の実装と比較して、パフォーマンスが大幅に向上しています。
プラットフォームの依存関係が排除され、デプロイとサービスが簡素化されます。 たとえば、
libcurl
は macOS 用の .NET Core と Linux 用の .NET Core への依存関係ではなくなりました。すべての .NET プラットフォームで一貫した動作。
この変更が望ましくなく、.NET Core 2.1-3.1 を使用している場合は、いくつかの方法で代わりに古い System.Net.Http.HttpClientHandler クラスを使用するようにアプリケーションを構成できます。
メソッドを AppContext.SetSwitch 次のように呼び出します。
C#AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", false);
AppContext.SetSwitch("System.Net.Http.UseSocketsHttpHandler", False)
.netcore.runtimeconfig.json構成ファイルでスイッチを定義
System.Net.Http.UseSocketsHttpHandler
します。JSON"runtimeOptions": { "configProperties": { "System.Net.Http.UseSocketsHttpHandler": false } }
という名前
DOTNET_SYSTEM_NET_HTTP_USESOCKETSHTTPHANDLER
の環境変数を定義し、それを または 0 にfalse
設定します。
これらの構成オプションは、.NET 5 以降では使用できません。
Sockets |
SocketsHttpHandler クラスのインスタンスを作成します。 |
Activity |
分散トレースとコンテキストを伝達するときに使用する伝達子を取得または設定します。
伝達を無効にするには、 を使用 |
Allow |
ハンドラーがリダイレクト応答に従うかどうかを示す値を取得または設定します。 |
Automatic |
HTTP コンテンツ応答を自動展開するためにハンドラーによって使用される展開メソッドの種類を取得または設定します。 |
Connect |
新しい接続を開くために使用するカスタム コールバックを取得または設定します。 |
Connect |
接続の確立がタイムアウトするまで待機する期間を取得または設定します。 |
Cookie |
マネージド クッキー コンテナー オブジェクトを取得または設定します。 |
Credentials |
このハンドラーで使用する認証情報を取得または設定します。 |
Default |
既定の (システム) プロキシが使用されている場合、認証のために既定のプロキシ サーバーに送信するための使用されている資格情報を取得または設定します。 |
Enable |
同じサーバーに対して追加の HTTP/2 接続を確立できるかどうかを示す値を取得または設定します。 |
Enable |
.NET Core 2.1 以降の HttpClient で使用される既定のメッセージ ハンドラーを提供します。 |
Expect100Continue |
サーバーの HTTP 100 Continue 応答のタイムアウト値を取得または設定します。 |
Initial |
この SocketsHttpHandlerによって開かれるすべての接続の初期 HTTP2 ストリーム受信ウィンドウ サイズを定義します。 |
Is |
ハンドラーが現在のプラットフォームでサポートされているかどうかを示す値を取得します。 |
Keep |
キープ アライブ ping の遅延を取得または設定します。 |
Keep |
キープ アライブ ping の動作を取得または設定します。 |
Keep |
キープ アライブ ping のタイムアウトを取得または設定します。 |
Max |
許可される HTTP リダイレクトの最大数を取得または設定します。 |
Max |
1 つのサーバーに対して許可されている同時 TCP 接続の最大数を取得または設定します。 |
Max |
応答からドレインできる最大データ量 (バイト単位) を取得または設定します。 |
Max |
応答ヘッダーの最大長 (KB 単位、1 KB = 1024 バイト) を取得または設定します。 |
Meter |
インスタンスのIMeterFactoryカスタムMeterSocketsHttpHandlerを作成する を取得または設定します。 |
Plaintext |
プレーンテキスト HTTP プロトコル ストリームへのアクセスを提供するカスタム コールバックを取得または設定します。 |
Pooled |
再利用可能と見なされるプールで接続がアイドル状態でいられる時間を取得または設定します。 |
Pooled |
再利用可能と見なされるために接続がプール内にいられる時間を取得または設定します。 |
Pre |
ハンドラーが要求と共に認証ヘッダーを送信するかどうかを示す値を取得または設定します。 |
Properties |
HttpClient 要求のカスタム プロパティの書き込み可能なディクショナリ (つまり、マップ) を取得します。 ディクショナリが初期化されて空になると、カスタム ハンドラーと特殊な処理のキーと値のペアを挿入してクエリを実行できます。 |
Proxy |
UseProxy プロパティが |
Request |
要求ヘッダー値をエンコードする を Encoding 選択するコールバックを取得または設定します。 |
Response |
データが応答からドレインされるのを待機する期間を取得または設定します。 |
Response |
応答ヘッダー値をデコードする を Encoding 選択するコールバックを取得または設定します。 |
Ssl |
クライアント TLS 認証に使用するオプションのセットを取得または設定します。 |
Use |
ハンドラーで Cookie を使用するかどうかを示す値を取得または設定します。 |
Use |
ハンドラーでプロキシを使用するかどうかを示す値を取得または設定します。 |
Dispose() |
HttpMessageHandler が使用しているアンマネージド リソースを解放し、マネージド リソースを破棄します。 (継承元 HttpMessageHandler) |
Dispose(Boolean) |
HttpMessageHandler が使用しているアンマネージド リソースを解放します。オプションとして、マネージド リソースを破棄することもできます。 (継承元 HttpMessageHandler) |
Equals(Object) |
指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object) |
Get |
既定のハッシュ関数として機能します。 (継承元 Object) |
Get |
現在のインスタンスの Type を取得します。 (継承元 Object) |
Memberwise |
現在の Object の簡易コピーを作成します。 (継承元 Object) |
Send(Http |
派生クラスでオーバーライドされた場合は、指定した要求とキャンセル トークンを使用して HTTP 要求を送信します。 それ以外の場合は、NotSupportedException をスローします。 (継承元 HttpMessageHandler) |
Send |
非同期操作として HTTP 要求を送信します。 (継承元 HttpMessageHandler) |
To |
現在のオブジェクトを表す文字列を返します。 (継承元 Object) |
製品 | バージョン |
---|---|
.NET | Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。