IHttpFilter.SendRequestAsync(HttpRequestMessage) Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
Objek yang mewakili operasi asinkron.
- Atribut
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 .