HttpMessageHandlerBuilder.CreateHandlerPipeline Метод

Определение

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

Microsoft.Extensions.Http

Сборка:

Microsoft.Extensions.Http.dll

Пакет:

Microsoft.Extensions.Http v11.0.0-preview.5.26302.115

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

HttpMessageHandlerBuilder.cs

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

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 экземпляров, вызываемых как часть отправки и получения HttpRequestMessageHttpResponseMessage. Обработчики вызываются в верхней части вниз. То есть первая запись вызывается сначала для исходящего сообщения запроса, но последней для входящего ответа.

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

HttpMessageHandler

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

Исключения

ArgumentNullException

primaryHandler или additionalHandlers есть null.

InvalidOperationException

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