HttpMessageHandlerBuilder.CreateHandlerPipeline Метод

Определение

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

Microsoft.Extensions.Http

Сборка:

Microsoft.Extensions.Http.dll

Пакет:

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

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

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

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

HttpMessageHandler

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

Исключения

ArgumentNullException

Параметр primaryHandler или additionalHandlers имеет значение null.

InvalidOperationException

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

-или-

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