HttpMessageHandlerBuilder.CreateHandlerPipeline Метод

Определение

Пространство имен:

Microsoft.Extensions.Http

Сборка:

Microsoft.Extensions.Http.dll

Пакет:

Microsoft.Extensions.Http v9.0.0-preview.7.24405.7

Исходный код:

HttpMessageHandlerBuilder.cs

Создает экземпляр HttpMessageHandler путем цепочки additionalHandlers друг за другом с primaryHandler в конце цепочки. Результирующий конвейер используется инфраструктурой IHttpClientFactory для создания экземпляров HttpClient с настраиваемыми обработчиками сообщений. Полученный конвейер также можно получить с помощью IHttpMessageHandlerFactory вместо IHttpClientFactory.

protected public:
 static System::Net::Http::HttpMessageHandler ^ CreateHandlerPipeline(System::Net::Http::HttpMessageHandler ^ primaryHandler, System::Collections::Generic::IEnumerable<System::Net::Http::DelegatingHandler ^> ^ additionalHandlers);

protected internal static System.Net.Http.HttpMessageHandler CreateHandlerPipeline (System.Net.Http.HttpMessageHandler primaryHandler, System.Collections.Generic.IEnumerable<System.Net.Http.DelegatingHandler> additionalHandlers);

static member CreateHandlerPipeline : System.Net.Http.HttpMessageHandler * seq<System.Net.Http.DelegatingHandler> -> System.Net.Http.HttpMessageHandler

Protected Friend Shared Function CreateHandlerPipeline (primaryHandler As HttpMessageHandler, additionalHandlers As IEnumerable(Of DelegatingHandler)) As HttpMessageHandler

Параметры

primaryHandler

HttpMessageHandler

Экземпляр HttpMessageHandler, который работает в нижней части цепочки обработчиков и фактически обрабатывает операции транспорта HTTP.

additionalHandlers

IEnumerable<DelegatingHandler>

Упорядоченный список DelegatingHandler экземпляров, которые необходимо вызвать в рамках отправки HttpRequestMessage и получения HttpResponseMessage. Обработчики вызываются в верхней части вниз. То есть первая запись вызывается сначала для исходящего сообщения запроса, но последней для входящего ответа.

Возвращаемое значение

HttpMessageHandler

Цепочка обработчика сообщений HTTP.

Исключения

ArgumentNullException

primaryHandler или additionalHandlers null.

InvalidOperationException

additionalHandlers содержит запись null.

-или-

DelegatingHandler.InnerHandler не null. DelegatingHandler экземпляры, предоставляемые HttpMessageHandlerBuilder, не должны использоваться повторно или кэшироваться.