HttpClient HttpClient HttpClient HttpClient Constructors

Definition

Überlädt

HttpClient() HttpClient() HttpClient()

Initialisiert eine neue Instanz der HttpClient-Klasse mithilfe eines HttpClientHandler-Objekts, das bei Freigabe dieser Instanz freigegeben wird.Initializes a new instance of the HttpClient class using a HttpClientHandler that is disposed when this instance is disposed.

HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler)

Initialisiert eine neue Instanz der HttpClient-Klasse mit dem angegebenen Handler.Initializes a new instance of the HttpClient class with the specified handler. Der Handler wird freigegeben, wenn diese Instanz freigegeben wird.The handler is disposed when this instance is disposed.

HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean) 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.Initializes a new instance of the HttpClient class with the provided handler, and specifies whether that handler should be disposed when this instance is disposed.

Hinweise

HttpClientsoll einmal instanziiert und während der gesamten Lebensdauer einer Anwendung wieder verwendet werden.HttpClient is intended to be instantiated once and re-used throughout the life of an application. Durch das Instanziieren einer HttpClient-Klasse für jede Anforderung wird die Anzahl der verfügbaren Sockets bei starker Auslastung erschöpft.Instantiating an HttpClient class for every request will exhaust the number of sockets available under heavy loads. Dies führt zu SocketException-Fehlern.This will result in SocketException errors. Im folgenden finden Sie ein Beispiel für die korrekte Verwendung von HttpClient.Below is an example using HttpClient correctly.

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() HttpClient() HttpClient()

Initialisiert eine neue Instanz der HttpClient-Klasse mithilfe eines HttpClientHandler-Objekts, das bei Freigabe dieser Instanz freigegeben wird.Initializes a new instance of the HttpClient class using a HttpClientHandler that is disposed when this instance is disposed.

public:
 HttpClient();
public HttpClient ();
Public Sub New ()

Hinweise

Die Verwendung dieses Konstruktors entspricht dem Aufrufen des HttpClient(new HttpClientHandler(), true) Konstruktors.Using this constructor is equivalent to calling the HttpClient(new HttpClientHandler(), true) constructor.

HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler) HttpClient(HttpMessageHandler)

Initialisiert eine neue Instanz der HttpClient-Klasse mit dem angegebenen Handler.Initializes a new instance of the HttpClient class with the specified handler. Der Handler wird freigegeben, wenn diese Instanz freigegeben wird.The handler is disposed when this instance is disposed.

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 HttpMessageHandler HttpMessageHandler HttpMessageHandler

Der HTTP-Handlerstapel, der zum Senden von Anforderungen zu verwenden ist.The HTTP handler stack to use for sending requests.

Ausnahmen

Hinweise

Die Verwendung dieses Konstruktors entspricht dem Aufrufen des HttpClient(handler, true) Konstruktors.Using this constructor is equivalent to calling the HttpClient(handler, true) constructor.

Der angegebene handler wird verworfen, indem HttpClient.verwerfen aufgerufen wird.The specified handler will be disposed of by calling HttpClient.Dispose.

HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean) HttpClient(HttpMessageHandler, Boolean) 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.Initializes a new instance of the HttpClient class with the provided handler, and specifies whether that handler should be disposed when this instance is disposed.

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 HttpMessageHandler HttpMessageHandler HttpMessageHandler

Der HttpMessageHandler, der für die Verarbeitung der HTTP-Antwortnachrichten verantwortlich ist.The HttpMessageHandler responsible for processing the HTTP response messages.

disposeHandler
Boolean Boolean Boolean Boolean

true, wenn der innere Handler durch HttpClient.Dispose freigegeben werden soll; false, wenn Sie beabsichtigen, den inneren Handler wiederzuverwenden.true if the inner handler should be disposed of by HttpClient.Dispose; false if you intend to reuse the inner handler.

Ausnahmen

Gilt für: