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
| 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.HttpClientPublic 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.HttpClientPublic 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.
