HttpClient 建構函式

定義

命名空間:

System.Net.Http

組件:

netstandard.dll, System.Net.Http.dll

初始化 HttpClient 類別的新執行個體。

多載

名稱	Description
HttpClient()	使用HttpClient當該實例被處置時，初始化類別的新實例HttpClientHandler。
HttpClient(HttpMessageHandler)	初始化一個新的類別實例 HttpClient ，使用指定的處理器。 當該實例被處理時，處理者即被處置。
HttpClient(HttpMessageHandler, Boolean)	初始化該類別的新實例 HttpClient ，並指定該處理器在處理時是否應被丟棄。

備註

HttpClient 旨在具現化一次，並在整個應用程式的生命週期中重複使用。 為每個請求實例化一個 HttpClient 類別，會耗盡在重負載下可用的 socket 數量。 這會導致 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當該實例被處置時，初始化類別的新實例HttpClientHandler。

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

負責 HttpMessageHandler 處理 HTTP 回應訊息。

disposeHandler

Boolean

true 若內部處理器應被 HttpClient.Dispose 處置; false 如果你打算重複使用內部操作者。

例外狀況

ArgumentNullException

handler 是 null。