IHttpClientFactory.CreateClient(String) Método

Definição

Namespace:

System.Net.Http

Assembly:

Microsoft.Extensions.Http.dll

Pacote:

Microsoft.Extensions.Http v8.0.0

Origem:

IHttpClientFactory.cs

Cria e configura uma instância de HttpClient usando a configuração que corresponde ao nome lógico especificado por name.

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

Parâmetros

name

String

O nome lógico do cliente a ser criado.

Retornos

HttpClient

Uma nova instância de HttpClient.

Comentários

Cada chamada para CreateClient(String) tem a garantia de retornar uma nova HttpClient instância. Os chamadores podem armazenar em cache a instância retornada HttpClient indefinidamente ou cercar seu uso em um using bloco para descartá-la quando desejado.

A implementação padrão IHttpClientFactory pode armazenar em cache as instâncias subjacentes HttpMessageHandler para melhorar o desempenho.

Os chamadores também são livres para alterar as propriedades públicas da instância retornada HttpClient conforme desejado.