Bagikan melalui


HttpClient.PostAsync(Uri, IHttpContent) Metode

Definisi

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

uri
Uri Uri

URI tempat permintaan dikirim.

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.

Berlaku untuk

Lihat juga