HttpClient.SendRequestAsync 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.
Overload
SendRequestAsync(HttpRequestMessage) |
Kirim permintaan HTTP sebagai operasi asinkron. Untuk panduan pemrograman untuk kelas HttpClient, dan contoh kode, lihat topik konseptual HttpClient . |
SendRequestAsync(HttpRequestMessage, HttpCompletionOption) |
Kirim permintaan HTTP dengan opsi penyelesaian HTTP sebagai operasi asinkron. Untuk panduan pemrograman untuk kelas HttpClient, dan contoh kode, lihat topik konseptual HttpClient . |
SendRequestAsync(HttpRequestMessage)
Kirim permintaan HTTP sebagai operasi asinkron. Untuk panduan pemrograman untuk kelas HttpClient, dan contoh kode, lihat topik konseptual HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request) = SendRequestAsync;
/// [Windows.Foundation.Metadata.Overload("SendRequestAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request);
[Windows.Foundation.Metadata.Overload("SendRequestAsync")]
[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
Operasi ini tidak akan memblokir. IAsyncOperationWithProgress yang dikembalikan (dari HttpResponseMessage dan HttpProgress) selesai setelah seluruh respons (termasuk konten) dibaca.
HttpRequestMessage yang diteruskan dalam parameter permintaan memungkinkan metode SendRequestAsync untuk mengatur header pada pesan permintaan serta pada konten HTTP yang akan dikirim. Sebaliknya, metode PostAsync dan PutAsync hanya memungkinkan pengaturan sekumpulan header konten HTTP yang lebih terbatas.
Di bawah ini adalah pengecualian yang dilemparkan fungsi ini.
E_ILLEGAL_METHOD_CALL
Pesan permintaan sudah dikirim oleh instans HttpClient .
Penanganan pengecualian
Anda harus menulis kode untuk menangani pengecualian ketika Anda memanggil metode ini. Pengecualian dapat diakibatkan oleh kesalahan validasi parameter, kegagalan resolusi nama, dan kesalahan jaringan. Pengecualian dari kesalahan jaringan (hilangnya konektivitas, kegagalan koneksi, dan kegagalan server HTTP, misalnya) dapat terjadi kapan saja. Kesalahan ini mengakibatkan pengecualian dilemparkan. Jika tidak ditangani oleh aplikasi Anda, pengecualian dapat menyebabkan seluruh aplikasi Anda dihentikan oleh runtime. Untuk informasi selengkapnya tentang cara menangani pengecualian, lihat Menangani pengecualian di aplikasi jaringan dan Cara: Memetakan HRESULT dan Pengecualian.
Lihat juga
- HttpRequestMessage
- PostAsync(Uri, IHttpContent)
- PutAsync(Uri, IHttpContent)
- SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
- HttpClient
Berlaku untuk
SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
Kirim permintaan HTTP dengan opsi penyelesaian HTTP sebagai operasi asinkron. Untuk panduan pemrograman untuk kelas HttpClient, dan contoh kode, lihat topik konseptual HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request, HttpCompletionOption completionOption) = SendRequestAsync;
/// [Windows.Foundation.Metadata.Overload("SendRequestWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request, HttpCompletionOption const& completionOption);
[Windows.Foundation.Metadata.Overload("SendRequestWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request, HttpCompletionOption completionOption);
function sendRequestAsync(request, completionOption)
Public Function SendRequestAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)
Parameter
- request
- HttpRequestMessage
Pesan permintaan HTTP untuk dikirim.
- completionOption
- HttpCompletionOption
Nilai yang menunjukkan apakah operasi HttpClient dianggap selesai ketika semua respons dibaca, atau ketika hanya header yang dibaca.
Mengembalikan
Objek yang mewakili operasi asinkron.
- Atribut
Keterangan
Operasi ini tidak akan memblokir. IAsyncOperationWithProgress yang dikembalikan (dari HttpResponseMessage dan HttpProgress) selesai tergantung pada nilai parameter completionOption.
HttpRequestMessage yang diteruskan dalam parameter permintaan memungkinkan metode SendRequestAsync untuk mengatur header pada pesan permintaan serta pada konten HTTP yang akan dikirim. Sebaliknya, metode PostAsync dan PutAsync hanya memungkinkan pengaturan sekumpulan header konten HTTP yang lebih terbatas.
Di bawah ini adalah pengecualian yang dilemparkan fungsi ini.
E_ILLEGAL_METHOD_CALL
Pesan permintaan sudah dikirim oleh instans HttpClient .
Penanganan pengecualian
Anda harus menulis kode untuk menangani pengecualian ketika Anda memanggil metode ini. Pengecualian dapat diakibatkan oleh kesalahan validasi parameter, kegagalan resolusi nama, dan kesalahan jaringan. Pengecualian dari kesalahan jaringan (hilangnya konektivitas, kegagalan koneksi, dan kegagalan server HTTP, misalnya) dapat terjadi kapan saja. Kesalahan ini mengakibatkan pengecualian dilemparkan. Jika tidak ditangani oleh aplikasi Anda, pengecualian dapat menyebabkan seluruh aplikasi Anda dihentikan oleh runtime. Untuk informasi selengkapnya tentang cara menangani pengecualian, lihat Menangani pengecualian di aplikasi jaringan dan Cara: Memetakan HRESULT dan Pengecualian.