HttpClient HttpClient HttpClient HttpClient Constructors

定義

オーバーロード

HttpClient() HttpClient() HttpClient()

このインスタンスが破棄されたときに破棄される HttpClientHandler を使用して、HttpClient クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpClient class using a HttpClientHandler that is disposed when this instance is disposed.

HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler)

指定したハンドラーを使用して、HttpClient クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpClient class with the specified handler. このインスタンスが破棄されたときに、ハンドラーは破棄されます。The handler is disposed when this instance is disposed.

HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean)

提供されたハンドラーを使用して、HttpClient クラスの新しいインスタンスを初期化し、このインスタンスが破棄されるときにそのハンドラーを破棄するかどうかを指定します。Initializes a new instance of the HttpClient class with the provided handler, and specifies whether that handler should be disposed when this instance is disposed.

注釈

HttpClientは、1回インスタンス化し、アプリケーションの有効期間全体に再利用することを目的としています。HttpClient is intended to be instantiated once and re-used throughout the life of an application. すべての要求に対して HttpClient クラスをインスタンス化すると、大量の読み込みで使用可能なソケットの数が枯渇します。Instantiating an HttpClient class for every request will exhaust the number of sockets available under heavy loads. これにより、SocketException エラーが発生します。This will result in SocketException errors. HttpClient を正しく使用する例を次に示します。Below is an example using HttpClient correctly.

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

このインスタンスが破棄されたときに破棄される HttpClientHandler を使用して、HttpClient クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpClient class using a HttpClientHandler that is disposed when this instance is disposed.

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

注釈

このコンストラクターの使用は、 HttpClient(new HttpClientHandler(), true)コンストラクターを呼び出すことと同じです。Using this constructor is equivalent to calling the HttpClient(new HttpClientHandler(), true) constructor.

HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler)

指定したハンドラーを使用して、HttpClient クラスの新しいインスタンスを初期化します。Initializes a new instance of the HttpClient class with the specified handler. このインスタンスが破棄されたときに、ハンドラーは破棄されます。The handler is disposed when this instance is disposed.

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 HttpMessageHandler HttpMessageHandler HttpMessageHandler

要求の送信に使用する HTTP ハンドラー スタック。The HTTP handler stack to use for sending requests.

例外

注釈

このコンストラクターの使用は、 HttpClient(handler, true)コンストラクターを呼び出すことと同じです。Using this constructor is equivalent to calling the HttpClient(handler, true) constructor.

指定さhandlerれたは、 httpclient. Disposeを呼び出すことによって破棄されます。The specified handler will be disposed of by calling HttpClient.Dispose.

HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean)

提供されたハンドラーを使用して、HttpClient クラスの新しいインスタンスを初期化し、このインスタンスが破棄されるときにそのハンドラーを破棄するかどうかを指定します。Initializes a new instance of the HttpClient class with the provided handler, and specifies whether that handler should be disposed when this instance is disposed.

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 HttpMessageHandler HttpMessageHandler HttpMessageHandler

HTTP 応答メッセージの処理を行う HttpMessageHandlerThe HttpMessageHandler responsible for processing the HTTP response messages.

disposeHandler
Boolean Boolean Boolean Boolean

内部ハンドラーを HttpClient.Dispose で破棄する場合は true。内部ハンドラーを再利用する場合は falsetrue if the inner handler should be disposed of by HttpClient.Dispose; false if you intend to reuse the inner handler.

例外

適用対象