HttpClient コンストラクター
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
HttpClient クラスの新しいインスタンスを初期化します。
オーバーロード
| 名前 | 説明 |
|---|---|
| HttpClient() |
このインスタンスが破棄されるときに破棄されるHttpClientを使用して、HttpClientHandler クラスの新しいインスタンスを初期化します。 |
| HttpClient(HttpMessageHandler) |
指定したハンドラーを使用して、 HttpClient クラスの新しいインスタンスを初期化します。 ハンドラーは、このインスタンスが破棄されるときに破棄されます。 |
| HttpClient(HttpMessageHandler, Boolean) |
指定されたハンドラーを使用して HttpClient クラスの新しいインスタンスを初期化し、このインスタンスが破棄されるときにそのハンドラーを破棄するかどうかを指定します。 |
注釈
HttpClient は、1 回インスタンス化され、アプリケーションの有効期間中に再利用されることを目的としています。 すべての要求に対して HttpClient クラスをインスタンス化すると、負荷が高い場合に使用可能なソケットの数が使い果たされます。 これにより、SocketException エラーが発生します。 HttpClient を正しく使用する例を次に示します。
public class GoodController : ApiController
{
private static readonly HttpClient HttpClient;
static GoodController()
{
HttpClient = new HttpClient();
}
}
Public Class GoodController
Inherits ApiController
Private Shared ReadOnly HttpClient As HttpClient
Shared Sub New()
HttpClient = New HttpClient()
End Sub
End Class
HttpClient()
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
このインスタンスが破棄されるときに破棄されるHttpClientを使用して、HttpClientHandler クラスの新しいインスタンスを初期化します。
public:
HttpClient();public HttpClient();Public Sub New ()注釈
このコンストラクターの使用は、 HttpClient(new HttpClientHandler(), true) コンストラクターの呼び出しと同じです。
適用対象
HttpClient(HttpMessageHandler)
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
指定したハンドラーを使用して、 HttpClient クラスの新しいインスタンスを初期化します。 ハンドラーは、このインスタンスが破棄されるときに破棄されます。
public:
HttpClient(System::Net::Http::HttpMessageHandler ^ handler);public HttpClient(System.Net.Http.HttpMessageHandler handler);new System.Net.Http.HttpClient : System.Net.Http.HttpMessageHandler -> System.Net.Http.HttpClientPublic Sub New (handler As HttpMessageHandler)パラメーター
- handler
- HttpMessageHandler
要求の送信に使用する HTTP ハンドラー スタック。
例外
handler は null です。
注釈
このコンストラクターの使用は、 HttpClient(handler, true) コンストラクターの呼び出しと同じです。
指定した handler は、 HttpClient.Dispose を呼び出すことによって破棄されます。
適用対象
HttpClient(HttpMessageHandler, Boolean)
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
- ソース:
- HttpClient.cs
指定されたハンドラーを使用して HttpClient クラスの新しいインスタンスを初期化し、このインスタンスが破棄されるときにそのハンドラーを破棄するかどうかを指定します。
public:
HttpClient(System::Net::Http::HttpMessageHandler ^ handler, bool disposeHandler);public HttpClient(System.Net.Http.HttpMessageHandler handler, bool disposeHandler);new System.Net.Http.HttpClient : System.Net.Http.HttpMessageHandler * bool -> System.Net.Http.HttpClientPublic Sub New (handler As HttpMessageHandler, disposeHandler As Boolean)パラメーター
- handler
- HttpMessageHandler
HTTP 応答メッセージの処理を担当する HttpMessageHandler 。
- disposeHandler
- Boolean
true 内部ハンドラーを HttpClient.Dispose によって破棄する必要がある場合。内部ハンドラーを再利用する場合は、 false します。
例外
handler は null です。
