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 Instanz zurückgegeben. Aufrufer können die zurückgegebene HttpClient Instanz unbegrenzt zwischenspeichern oder ihre Verwendung in einem using Block umschließen, um sie nach Bedarf zu entsorgen.

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

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