HttpClient Konstruktory

Definicja

Inicjuje nowe wystąpienie klasy HttpClient.

Przeciążenia

HttpClient()

Inicjuje HttpClient nowe wystąpienie klasy przy użyciu usuniętego HttpClientHandler wystąpienia, gdy to wystąpienie zostanie usunięte.

HttpClient(HttpMessageHandler)

Inicjuje HttpClient nowe wystąpienie klasy przy użyciu określonej procedury obsługi. Procedura obsługi jest usuwana po usunięciu tego wystąpienia.

HttpClient(HttpMessageHandler, Boolean)

Inicjuje nowe wystąpienie HttpClient klasy z podaną procedurą obsługi i określa, czy ta procedura obsługi powinna zostać usunięta po usunięciu tego wystąpienia.

Uwagi

HttpClient jest przeznaczony do utworzenia wystąpienia raz i ponownego użycia przez cały czas stosowania. Utworzenie wystąpienia klasy HttpClient dla każdego żądania spowoduje wyczerpanie liczby gniazd dostępnych pod dużym obciążeniem. Spowoduje to błędy SocketException. Poniżej przedstawiono przykład, który poprawnie używa obiektu HttpClient.

public class GoodController : ApiController
{
    private static readonly HttpClient HttpClient;

    static GoodController()
    {
        HttpClient = new HttpClient();
    }
}

HttpClient()

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Źródło:
HttpClient.cs

Inicjuje HttpClient nowe wystąpienie klasy przy użyciu usuniętego HttpClientHandler wystąpienia, gdy to wystąpienie zostanie usunięte.

public HttpClient ();

Uwagi

Użycie tego konstruktora jest równoważne wywołaniu konstruktora HttpClient(new HttpClientHandler(), true) .

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

HttpClient(HttpMessageHandler)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Źródło:
HttpClient.cs

Inicjuje HttpClient nowe wystąpienie klasy przy użyciu określonej procedury obsługi. Procedura obsługi jest usuwana po usunięciu tego wystąpienia.

public HttpClient (System.Net.Http.HttpMessageHandler handler);

Parametry

handler
HttpMessageHandler

Stos obsługi HTTP używany do wysyłania żądań.

Wyjątki

Element handler to null.

Uwagi

Użycie tego konstruktora jest równoważne wywołaniu konstruktora HttpClient(handler, true) .

Określona handler wartość zostanie usunięta przez wywołanie metody HttpClient.Dispose.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

HttpClient(HttpMessageHandler, Boolean)

Źródło:
HttpClient.cs
Źródło:
HttpClient.cs
Źródło:
HttpClient.cs

Inicjuje nowe wystąpienie HttpClient klasy z podaną procedurą obsługi i określa, czy ta procedura obsługi powinna zostać usunięta po usunięciu tego wystąpienia.

public HttpClient (System.Net.Http.HttpMessageHandler handler, bool disposeHandler);

Parametry

handler
HttpMessageHandler

Odpowiedzialne HttpMessageHandler za przetwarzanie komunikatów odpowiedzi HTTP.

disposeHandler
Boolean

true jeśli program obsługi wewnętrznej powinien zostać usunięty przez httpClient.Dispose; false jeśli zamierzasz ponownie użyć procedury obsługi wewnętrznej.

Wyjątki

Element handler to null.

Dotyczy

.NET 9 i inne wersje
Produkt Wersje
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0