HttpMessageHandlerBuilder.CreateHandlerPipeline Metode

Definisi

Ruang nama:

Microsoft.Extensions.Http

Rakitan:

Microsoft.Extensions.Http.dll

Paket:

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

Sumber:

HttpMessageHandlerBuilder.cs

Membangun instans HttpMessageHandler dengan menautkan additionalHandlers satu demi satu dengan primaryHandler di akhir rantai. Alur yang dihasilkan digunakan oleh IHttpClientFactory infrastruktur untuk membuat HttpClient instans dengan penangan pesan yang disesuaikan. Alur yang dihasilkan juga dapat diakses dengan menggunakan IHttpMessageHandlerFactory alih-alih 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

Parameter

primaryHandler

HttpMessageHandler

Instans HttpMessageHandler untuk beroperasi di bagian bawah rantai handler dan benar-benar menangani operasi transportasi HTTP.

additionalHandlers

IEnumerable<DelegatingHandler>

Daftar DelegatingHandler instans yang diurutkan untuk dipanggil sebagai bagian dari pengiriman HttpRequestMessage dan penerimaan HttpResponseMessage. Handler dipanggil dengan cara top-down. Artinya, entri pertama dipanggil terlebih dahulu untuk pesan permintaan keluar tetapi terakhir untuk pesan respons masuk.

Mengembalikan

HttpMessageHandler

Rantai handler pesan HTTP.

Pengecualian

ArgumentNullException

primaryHandler atau additionalHandlers adalah null.

InvalidOperationException

additionalHandlers null berisi entri.

-atau-

DelegatingHandler.InnerHandler bukan null. DelegatingHandler instans yang disediakan untuk HttpMessageHandlerBuilder tidak boleh digunakan kembali atau di-cache.