HttpClient Konstruktoren
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Initialisiert eine neue Instanz der HttpClient-Klasse.
Überlädt
| Name | Beschreibung |
|---|---|
| HttpClient() |
Initialisiert eine neue Instanz der HttpClient Klasse unter Verwendung eines HttpClientHandler Verworfens, wenn diese Instanz verworfen wird. |
| HttpClient(HttpMessageHandler) |
Initialisiert eine neue Instanz der HttpClient Klasse mit dem angegebenen Handler. Der Handler wird verworfen, wenn diese Instanz verworfen wird. |
| HttpClient(HttpMessageHandler, Boolean) |
Initialisiert eine neue Instanz der HttpClient Klasse mit dem bereitgestellten Handler und gibt an, ob dieser Handler verworfen werden soll, wenn diese Instanz verworfen 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, die unter schweren Lasten verfügbar sind, erschöpft. Dies führt zu SocketException-Fehlern. Nachfolgend sehen Sie ein Beispiel für die ordnungsgemäße 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()
Initialisiert eine neue Instanz der HttpClient Klasse unter Verwendung eines HttpClientHandler Verworfens, wenn diese Instanz verworfen 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)
Initialisiert eine neue Instanz der HttpClient Klasse mit dem angegebenen Handler. Der Handler wird verworfen, wenn diese Instanz verworfen 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.HttpClientPublic Sub New (handler As HttpMessageHandler)Parameter
- handler
- HttpMessageHandler
Der HTTP-Handlerstapel, der zum Senden von Anforderungen verwendet werden soll.
Ausnahmen
handler ist null.
Hinweise
Die Verwendung dieses Konstruktors entspricht dem Aufrufen des HttpClient(handler, true) Konstruktors.
Der angegebene handler Parameter wird durch Aufrufen von HttpClient.Dispose verworfen.
Gilt für:
HttpClient(HttpMessageHandler, Boolean)
Initialisiert eine neue Instanz der HttpClient Klasse mit dem bereitgestellten Handler und gibt an, ob dieser Handler verworfen werden soll, wenn diese Instanz verworfen 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.HttpClientPublic Sub New (handler As HttpMessageHandler, disposeHandler As Boolean)Parameter
- handler
- HttpMessageHandler
Verantwortlich HttpMessageHandler für die Verarbeitung der HTTP-Antwortnachrichten.
- disposeHandler
- Boolean
true wenn der innere Handler von HttpClient.Dispose verworfen werden soll; false wenn Sie den inneren Handler wiederverwenden möchten.
Ausnahmen
handler ist null.