HttpClient Konstruktoren

Definition

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
Quelle:
HttpClient.cs
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.

Gilt für:

HttpClient(HttpMessageHandler)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
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

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.

Gilt für:

HttpClient(HttpMessageHandler, Boolean)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
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

handler ist null.

Gilt für: