IHttpClientFactory.CreateClient(String) Methode

Definition

Namespace:

System.Net.Http

Assembly:

Microsoft.Extensions.Http.dll

Paket:

Microsoft.Extensions.Http v8.0.0

Quelle:

IHttpClientFactory.cs

Erstellt und konfiguriert eine HttpClient-Instanz mithilfe der Konfiguration, die dem logischen Namen entspricht, der durch name angegeben wird.

public:
 System::Net::Http::HttpClient ^ CreateClient(System::String ^ name);

public System.Net.Http.HttpClient CreateClient (string name);

abstract member CreateClient : string -> System.Net.Http.HttpClient

Public Function CreateClient (name As String) As HttpClient

Parameter

name

String

Der logische Name des zu erstellenden Clients.

Gibt zurück

HttpClient

Eine neue HttpClient-Instanz.

Hinweise

Bei jedem Aufruf von CreateClient(String) wird garantiert eine neue HttpClient instance zurückgegeben. Aufrufer können die zurückgegebenen HttpClient instance unbegrenzt zwischenspeichern oder die Verwendung in einem using -Block einschließen, um sie bei Bedarf zu löschen.

Die Standardimplementierung IHttpClientFactory kann die zugrunde liegenden HttpMessageHandler Instanzen zwischenspeichern, um die Leistung zu verbessern.

Aufrufer können auch die zurückgegebenen HttpClient öffentlichen Eigenschaften der instance wie gewünscht mutieren.