Bagikan melalui

HttpClient.SendRequestAsync Metode

  • Referensi

Definisi

Ruang nama:
Windows.Web.Http

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)

Edit

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

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

Objek yang mewakili operasi asinkron.

Atribut
OverloadAttribute RemoteAsyncAttribute

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

Berlaku untuk

SendRequestAsync(HttpRequestMessage, HttpCompletionOption)

Edit

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

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

Objek yang mewakili operasi asinkron.

Atribut
OverloadAttribute RemoteAsyncAttribute

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.

Lihat juga

Berlaku untuk