HttpClient コンストラクター

定義

名前空間:

System.Net.Http

アセンブリ:

System.Net.Http.dll

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

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

public:
 HttpClient();

public HttpClient ();

Public Sub New ()

注釈

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

HttpClient(HttpMessageHandler)

ソース:

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 ハンドラー スタック。

例外

ArgumentNullException

handler は null です。

注釈

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

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

HttpClient(HttpMessageHandler, Boolean)

ソース:

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。

例外

ArgumentNullException

handler が null です。