次の方法で共有


HttpClient コンストラクター

定義

HttpClient クラスの新しいインスタンスを初期化します。

オーバーロード

HttpClient()

このインスタンスが破棄されたときに破棄される HttpClientHandler を使用して、HttpClient クラスの新しいインスタンスを初期化します。

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

このインスタンスが破棄されたときに破棄される HttpClientHandler を使用して、HttpClient クラスの新しいインスタンスを初期化します。

public:
 HttpClient();
public HttpClient ();
Public Sub New ()

注釈

このコンストラクターの使用は、HttpClient(new HttpClientHandler(), true) コンストラクターを呼び出すことと同じです。

適用対象

HttpClient(HttpMessageHandler)

ソース:
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.HttpClient
Public Sub New (handler As HttpMessageHandler)

パラメーター

handler
HttpMessageHandler

要求の送信に使用する HTTP ハンドラー スタック。

例外

handlernull です。

注釈

このコンストラクターの使用は、HttpClient(handler, true) コンストラクターを呼び出すことと同じです。

指定した handler は、 HttpClient.Dispose を呼び出すことによって破棄されます。

適用対象

HttpClient(HttpMessageHandler, Boolean)

ソース:
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.HttpClient
Public Sub New (handler As HttpMessageHandler, disposeHandler As Boolean)

パラメーター

handler
HttpMessageHandler

HTTP 応答メッセージの処理を行う HttpMessageHandler

disposeHandler
Boolean

内部ハンドラーを HttpClient.Dispose で破棄する場合は true。内部ハンドラーを再利用する場合は false

例外

handlernull です。

適用対象