HttpClient Konstruktory

Definicja

Przestrzeń nazw:

System.Net.Http

Zestawy:

netstandard.dll, System.Net.Http.dll

Inicjuje nowe wystąpienie klasy HttpClient.

Przeciążenia

Nazwa	Opis
HttpClient()	Inicjuje HttpClient nowe wystąpienie klasy przy użyciu HttpClientHandler klasy, która jest usuwana po usunięciu tego wystąpienia.
HttpClient(HttpMessageHandler)	Inicjuje nowe wystąpienie HttpClient 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 stworzony raz i ponownego użycia przez cały okres życia aplikacji. 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 poprawnego używania klienta 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()

Źródło:

HttpClient.cs

Inicjuje HttpClient nowe wystąpienie klasy przy użyciu HttpClientHandler klasy, która jest usuwana po usunięciu tego wystąpienia.

public:
 HttpClient();

public HttpClient();

Public Sub New ()

Uwagi

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

HttpClient(HttpMessageHandler)

Źródło:

HttpClient.cs

Inicjuje nowe wystąpienie HttpClient 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);

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

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

Wyjątki

ArgumentNullException

handler jest null.

Uwagi

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

Określony handler element zostanie usunięty przez wywołanie metody HttpClient.Dispose.

HttpClient(HttpMessageHandler, Boolean)

Ź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);

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

Odpowiedzialny 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ć programu obsługi wewnętrznej.

Wyjątki

ArgumentNullException

handler jest null.