IHttpFilter.SendRequestAsync(HttpRequestMessage) Metode

Definisi

Ruang nama:

Windows.Web.Http.Filters

Kirim permintaan HTTP pada instans IHttpFilter sebagai operasi asinkron.

public:
 IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request);

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request);

function sendRequestAsync(request)

Public Function SendRequestAsync (request As HttpRequestMessage) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Parameter

request

HttpRequestMessage

Pesan permintaan HTTP untuk dikirim.

Mengembalikan

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

Objek yang mewakili operasi asinkron.

Atribut

RemoteAsyncAttribute

Keterangan

Filter kustom diimplementasikan dalam metode SendRequestAsync pada antarmuka IHttpFilter mereka.

Kelas di namespace Windows.Web.Http mendukung penggunaan filter berdasarkan kelas di namespace Windows.Web.Http.Filters . Kelas HttpClient di namespace Windows.Web.Http menyediakan kelas dasar untuk mengirim permintaan HTTP dan menerima respons HTTP. Filter menyediakan mekanisme handler untuk membantu masalah layanan HTTP umum. Filter sederhana dapat dirangkai bersama dalam urutan untuk menangani masalah layanan HTTP yang lebih kompleks.

Filter HTTP adalah kotak hitam yang mengambil pesan permintaan HTTP dan menghasilkan pesan respons HTTP. Bagaimana filter mendapatkan respons HTTP ditentukan oleh pengembang filter. Aplikasi dapat segera membuat respons, aplikasi dapat mengirim permintaan melalui TCP ke server, bahkan dapat mengirim beberapa permintaan ke server (atau ke lebih dari satu server) sebelum menghasilkan pesan respons. Karena tidak ditentukan bagaimana filter masuk ke pesan respons, filter dapat meneruskan pesan permintaan ke filter lain (disebut filter dalam), sehingga mendelegasikan pembuatan pesan respons ke filter dalam.

Filter biasanya menambahkan atau mengubah header, menangani otorisasi (mungkin menggunakan WebAuthenticationBroker), atau mengizinkan atau melarang permintaan berdasarkan kondisi jaringan. Filter biasanya membuat perubahan lalu meneruskan permintaan ke filter dalam, yang biasanya diatur saat filter dibuat.

Pendekatan ini memungkinkan filter untuk hanya bertanggung jawab atas aspek tertentu dari eksekusi permintaan HTTP dan mendelegasikan aspek lain ke filter lain. Filter dapat menerapkan penembolokan, autentikasi, pengalihan, cookie, komunikasi aktual dengan server, atau kombinasi ini. Filter paling bawah (dasar) biasanya akan menjadi filter yang melakukan komunikasi aktual dengan jaringan.

Di bawah ini adalah beberapa pengecualian yang dilemparkan fungsi ini.

E_INVALIDARG

Parameter permintaan adalah referensi null (Tidak ada di Visual Basic).

E_ILLEGAL_METHOD_CALL

Pesan permintaan sudah dikirim oleh instans IHttpFilter .