HttpMessageHandlerBuilder.CreateHandlerPipeline Yöntem

Tanım

Ad Alanı:

Microsoft.Extensions.Http

Bütünleştirilmiş Kod:

Microsoft.Extensions.Http.dll

Paket:

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

Kaynak:

HttpMessageHandlerBuilder.cs

Bir örneğini, zincirin HttpMessageHandler sonundaki ile primaryHandler birbiri ardına zincirleyerek additionalHandlers oluşturur. Sonuçta elde edilen işlem hattı, altyapı tarafından IHttpClientFactory özelleştirilmiş ileti işleyicileri olan örnekler oluşturmak HttpClient için kullanılır. Sonuçta elde edilen işlem hattına yerine IHttpClientFactorykullanılarak IHttpMessageHandlerFactory da erişilebilir.

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

Parametreler

primaryHandler

HttpMessageHandler

İşleyici zincirinin altında çalışmak ve aslında HTTP aktarım işlemlerini işlemek için bir örneği HttpMessageHandler .

additionalHandlers

IEnumerable<DelegatingHandler>

gönderme ve alma işleminin DelegatingHandler bir parçası olarak çağrılacak örneklerin HttpRequestMessage sıralı listesi HttpResponseMessage. İşleyiciler yukarıdan aşağıya doğru çağrılır. Diğer bir ifadeyle, ilk giriş ilk olarak bir giden istek iletisi için çağrılır, ancak gelen yanıt iletisi için son olarak çağrılır.

Döndürülenler

HttpMessageHandler

HTTP ileti işleyici zinciri.

Özel durumlar

ArgumentNullException

primaryHandler veya additionalHandlers şeklindedir null.

InvalidOperationException

additionalHandlers bir null giriş içerir.

-veya-

DelegatingHandler.InnerHandler değildir null. DelegatingHandler için sağlanan HttpMessageHandlerBuilder örneklerin yeniden kullanılması veya önbelleğe alınmaması gerekir.