HttpClient Konstruktoren

Definition

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

Initialisiert eine neue Instanz der HttpClient-Klasse.

Überlädt

HttpClient()	Initialisiert eine neue Instanz der HttpClient-Klasse mithilfe eines HttpClientHandler-Objekts, das bei Freigabe dieser Instanz freigegeben wird.
HttpClient(HttpMessageHandler)	Initialisiert eine neue Instanz der HttpClient-Klasse mit dem angegebenen Handler. Der Handler wird freigegeben, wenn diese Instanz freigegeben wird.
HttpClient(HttpMessageHandler, Boolean)	Initialisiert eine neue Instanz der HttpClient-Klasse mit dem bereitgestellten Handler und gibt an, ob dieser Handler freigegeben werden soll, wenn diese Instanz freigegeben wird.

Hinweise

HttpClient soll einmal instanziiert und während der gesamten Lebensdauer einer Anwendung wiederverwendet werden. Durch das Instanziieren einer HttpClient-Klasse für jede Anforderung wird die Anzahl der sockets erschöpft, die unter hoher Last verfügbar sind. Dies führt zu SocketException-Fehlern. Im Folgenden finden Sie ein Beispiel für die korrekte Verwendung von 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()

Quelle:

HttpClient.cs

Initialisiert eine neue Instanz der HttpClient-Klasse mithilfe eines HttpClientHandler-Objekts, das bei Freigabe dieser Instanz freigegeben wird.

public:
 HttpClient();

public HttpClient ();

Public Sub New ()

Hinweise

Die Verwendung dieses Konstruktors entspricht dem Aufrufen des HttpClient(new HttpClientHandler(), true) Konstruktors.

HttpClient(HttpMessageHandler)

Quelle:

HttpClient.cs

Initialisiert eine neue Instanz der HttpClient-Klasse mit dem angegebenen Handler. Der Handler wird freigegeben, wenn diese Instanz freigegeben wird.

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)

Parameter

handler

HttpMessageHandler

Der HTTP-Handlerstapel, der zum Senden von Anforderungen zu verwenden ist.

Ausnahmen

ArgumentNullException

Der Jointyp (handler) lautet null.

Hinweise

Die Verwendung dieses Konstruktors entspricht dem Aufrufen des HttpClient(handler, true) Konstruktors.

Das angegebene handler wird durch Aufrufen von HttpClient.Dispose verworfen.

HttpClient(HttpMessageHandler, Boolean)

Quelle:

HttpClient.cs

Initialisiert eine neue Instanz der HttpClient-Klasse mit dem bereitgestellten Handler und gibt an, ob dieser Handler freigegeben werden soll, wenn diese Instanz freigegeben wird.

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)

Parameter

handler

HttpMessageHandler

Der HttpMessageHandler, der für die Verarbeitung der HTTP-Antwortnachrichten verantwortlich ist.

disposeHandler

Boolean

true, wenn der innere Handler durch HttpClient.Dispose freigegeben werden soll; false, wenn Sie beabsichtigen, den inneren Handler wiederzuverwenden.

Ausnahmen

ArgumentNullException

handler ist null.