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

適用対象