HttpMessageHandlerBuilder.CreateHandlerPipeline Yöntem

Tanım

Ad Alanı:

Microsoft.Extensions.Http

Bütünleştirilmiş Kod:

Microsoft.Extensions.Http.dll

Paket:

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

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 en 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 HttpRequestMessage ve alma işleminin DelegatingHandler bir parçası olarak çağrılacak örneklerin sıralı listesiHttpResponseMessage. İşleyiciler yukarıdan aşağıya doğru çağrılır. Diğer bir ifadeyle, ilk girdi ilk olarak bir giden istek iletisi için çağrılır, ancak gelen yanıt iletisi için son olarak kullanılır.

Döndürülenler

HttpMessageHandler

HTTP ileti işleyici zinciri.

Özel durumlar

ArgumentNullException

primaryHandler veya additionalHandlers şeklindedir null.

InvalidOperationException

additionalHandlers bir null girdi içerir. -veya- DelegatingHandler.InnerHandler özelliği olmalıdır null. DelegatingHandler için sağlanan HttpMessageHandlerBuilder örneklerin yeniden kullanılması veya önbelleğe alınmaması gerekir.