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()

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

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

注釈

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

適用対象

HttpClient(HttpMessageHandler)

指定したハンドラーを使用して、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 クラスの新しいインスタンスを初期化し、このインスタンスが破棄されるときにそのハンドラーを破棄するかどうかを指定します。

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 です。

適用対象