HttpClient.PostAsync(Uri, IHttpContent) 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 POST ke URI yang ditentukan sebagai operasi asinkron. Untuk panduan pemrograman untuk kelas HttpClient, dan contoh kode, lihat topik konseptual HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ PostAsync(Uri ^ uri, IHttpContent ^ content) = PostAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> PostAsync(Uri const& uri, IHttpContent const& content);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> PostAsync(System.Uri uri, IHttpContent content);
function postAsync(uri, content)
Public Function PostAsync (uri As Uri, content As IHttpContent) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)
Parameter
- content
- IHttpContent
Konten permintaan HTTP untuk dikirim ke server.
Mengembalikan
Objek yang mewakili operasi asinkron.
- Atribut
Contoh
Lihat HttpClient untuk contoh panggilan HttpClient.PostAsync.
Keterangan
Operasi ini tidak akan memblokir. IAsyncOperationWithProgress yang dikembalikan (dariHttpResponseMessage dan HttpProgress) selesai setelah seluruh respons (termasuk konten) dibaca.
Metode PostAsync dan PutAsync hanya memungkinkan pengaturan header konten HTTP dalam jumlah terbatas. Sebaliknya, metode SendRequestAsync memungkinkan pengaturan header pada pesan permintaan serta pada konten HTTP yang akan dikirim.
Di bawah ini adalah pengecualian yang dilemparkan fungsi ini.
E_INVALIDARG
Parameter uri adalah referensi null (Tidak ada di Visual Basic).
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.