HttpClient Konstruktory

Definice

Obor názvů:

System.Net.Http

Sestavení:

netstandard.dll, System.Net.Http.dll

Inicializuje novou instanci HttpClient třídy.

Přetížení

Name	Description
HttpClient()	Inicializuje novou instanci HttpClient třídy pomocí HttpClientHandler , který je uvolněn, když je tato instance uvolněna.
HttpClient(HttpMessageHandler)	Inicializuje novou instanci HttpClient třídy se zadanou obslužnou rutinou. Obslužná rutina je uvolněna při odstranění této instance.
HttpClient(HttpMessageHandler, Boolean)	Inicializuje novou instanci třídy s poskytnutou HttpClient obslužnou rutinou a určuje, zda má být obslužná rutina uvolněna při odstranění této instance.

Poznámky

HttpClient je určena k vytvoření instance jednou a opakovanému použití v průběhu celé životnosti aplikace. Vytvoření instance třídy HttpClient pro každý požadavek vyčerpá počet soketů dostupných při velkém zatížení. Výsledkem budou chyby SocketException. Níže je příklad, který správně používá 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()

Zdroj:

HttpClient.cs

Inicializuje novou instanci HttpClient třídy pomocí HttpClientHandler , který je uvolněn, když je tato instance uvolněna.

public:
 HttpClient();

public HttpClient();

Public Sub New ()

Poznámky

Použití tohoto konstruktoru je ekvivalentní volání konstruktoru HttpClient(new HttpClientHandler(), true) .

HttpClient(HttpMessageHandler)

Zdroj:

HttpClient.cs

Inicializuje novou instanci HttpClient třídy se zadanou obslužnou rutinou. Obslužná rutina je uvolněna při odstranění této instance.

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)

Parametry

handler

HttpMessageHandler

Zásobník obslužné rutiny HTTP, který se má použít k odesílání požadavků.

Výjimky

ArgumentNullException

To handler je null.

Poznámky

Použití tohoto konstruktoru je ekvivalentní volání konstruktoru HttpClient(handler, true) .

Zadaná handler hodnota bude uvolněna voláním HttpClient.Dispose.

HttpClient(HttpMessageHandler, Boolean)

Zdroj:

HttpClient.cs

Inicializuje novou instanci třídy s poskytnutou HttpClient obslužnou rutinou a určuje, zda má být obslužná rutina uvolněna při odstranění této instance.

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)

Parametry

handler

HttpMessageHandler

Zodpovídá HttpMessageHandler za zpracování zpráv odpovědí HTTP.

disposeHandler

Boolean

true pokud má být vnitřní obslužná rutina odstraněna httpClient.Dispose; false pokud chcete znovu použít vnitřní obslužnou rutinu.

Výjimky

ArgumentNullException

To handler je null.