Bagikan melalui

WebClient.UploadValuesAsync Metode

  • Referensi

Definisi

Ruang nama:
System.Net
Rakitan:
System.Net.WebClient.dll
Rakitan:
System.dll
Rakitan:
netstandard.dll

Mengunggah kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan. Metode ini tidak memblokir utas panggilan.

Overload

UploadValuesAsync(Uri, NameValueCollection)

Mengunggah data dalam kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan. Metode ini tidak memblokir utas panggilan.
UploadValuesAsync(Uri, String, NameValueCollection)

Mengunggah data dalam kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan, menggunakan metode yang ditentukan. Metode ini tidak memblokir utas panggilan.
UploadValuesAsync(Uri, String, NameValueCollection, Object)

Mengunggah data dalam kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan, menggunakan metode yang ditentukan. Metode ini tidak memblokir utas panggilan, dan memungkinkan pemanggil untuk meneruskan objek ke metode yang dipanggil ketika operasi selesai.

UploadValuesAsync(Uri, NameValueCollection)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah data dalam kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan. Metode ini tidak memblokir utas panggilan.

public:
 void UploadValuesAsync(Uri ^ address, System::Collections::Specialized::NameValueCollection ^ data);
public void UploadValuesAsync (Uri address, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesAsync : Uri * System.Collections.Specialized.NameValueCollection -> unit
Public Sub UploadValuesAsync (address As Uri, data As NameValueCollection)

Parameter

address
Uri

URI sumber daya untuk menerima koleksi. URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode default.

data
NameValueCollection

NameValueCollection untuk dikirim ke sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode ini mengirim string ke sumber daya. String dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Sebelum mengunggah string, metode ini mengonversinya ke array Byte menggunakan pengodean yang ditentukan dalam properti Encoding. Untuk menerima pemberitahuan saat unggahan string selesai, Anda dapat menambahkan penanganan aktivitas ke peristiwa UploadStringCompleted.

Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok saat menunggu respons server, gunakan salah satu metode UploadString.

Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil metode CancelAsync.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string kosong, properti ditambahkan ke address.

Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh UploadValues(Uri, NameValueCollection).

Berlaku untuk

UploadValuesAsync(Uri, String, NameValueCollection)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah data dalam kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan, menggunakan metode yang ditentukan. Metode ini tidak memblokir utas panggilan.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data);
public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data);
public void UploadValuesAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data);
member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection -> unit
Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection)

Parameter

address
Uri

URI sumber daya untuk menerima koleksi. URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode method.

method
String

Metode yang digunakan untuk mengirim string ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

data
NameValueCollection

NameValueCollection untuk dikirim ke sumber daya.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

method tidak dapat digunakan untuk mengirim isi.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode ini mengirim data yang terkandung dalam NameValueCollection ke sumber daya address. Gunakan metode ini untuk mengirim data formulir ke URI untuk diproses. Data dikirim menggunakan jenis media yang dikodekan url formulir; nilai header Jenis Konten harus diatur ke "application/x-www-form-urlencoded". Header diatur dengan benar secara default. Metode UploadValuesAsync melemparkan WebException jika Anda memanggil metode ini dengan nilai header Jenis Konten yang berbeda yang diatur dalam koleksi Headers.

Jika metode method tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

NameValueCollection dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat operasi pengunggahan selesai, tambahkan penanganan aktivitas ke peristiwa UploadValuesCompleted.

Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok saat menunggu respons server, gunakan salah satu metode UploadValues.

Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil metode CancelAsync.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString tidak kosong, properti ditambahkan ke address.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Metode ini disimpan dalam tugas yang mengembalikan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh UploadValues(Uri, String, NameValueCollection).

Berlaku untuk

UploadValuesAsync(Uri, String, NameValueCollection, Object)

Sumber:
WebClient.cs
Sumber:
WebClient.cs
Sumber:
WebClient.cs

Mengunggah data dalam kumpulan nama/nilai yang ditentukan ke sumber daya yang diidentifikasi oleh URI yang ditentukan, menggunakan metode yang ditentukan. Metode ini tidak memblokir utas panggilan, dan memungkinkan pemanggil untuk meneruskan objek ke metode yang dipanggil ketika operasi selesai.

public:
 void UploadValuesAsync(Uri ^ address, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ data, System::Object ^ userToken);
public void UploadValuesAsync (Uri address, string? method, System.Collections.Specialized.NameValueCollection data, object? userToken);
public void UploadValuesAsync (Uri address, string method, System.Collections.Specialized.NameValueCollection data, object userToken);
member this.UploadValuesAsync : Uri * string * System.Collections.Specialized.NameValueCollection * obj -> unit
Public Sub UploadValuesAsync (address As Uri, method As String, data As NameValueCollection, userToken As Object)

Parameter

address
Uri

URI sumber daya untuk menerima koleksi. URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode method.

method
String

Metode HTTP yang digunakan untuk mengirim string ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.

data
NameValueCollection

NameValueCollection untuk dikirim ke sumber daya.

userToken
Object

Objek yang ditentukan pengguna yang diteruskan ke metode yang dipanggil ketika operasi asinkron selesai.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter datanull.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

method tidak dapat digunakan untuk mengirim isi.

Keterangan

Hati

WebRequest, HttpWebRequest, ServicePoint, dan WebClient usang, dan Anda tidak boleh menggunakannya untuk pengembangan baru. Gunakan HttpClient sebagai gantinya.

Metode ini mengirim data yang terkandung dalam NameValueCollection ke sumber daya address. Gunakan metode ini untuk mengirim data formulir ke URI untuk diproses. Data dikirim menggunakan jenis media yang dikodekan url formulir; nilai header Jenis Konten harus diatur ke "application/x-www-form-urlencoded". Header diatur dengan benar secara default. Metode UploadValuesAsync melemparkan WebException jika Anda memanggil metode ini dengan nilai header Jenis Konten yang berbeda yang diatur dalam koleksi Headers.

Jika metode method tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, WebException dilemparkan dengan properti Status diatur untuk menunjukkan kesalahan.

NameValueCollection dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat operasi pengunggahan selesai, tambahkan penanganan aktivitas ke peristiwa UploadValuesCompleted.

Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok saat menunggu respons server, gunakan salah satu metode UploadValues.

Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil metode CancelAsync.

Jika properti BaseAddress bukan string kosong ("") dan address tidak berisi URI absolut, address harus URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString tidak kosong, properti ditambahkan ke address.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing di .NET Framework.

Berlaku untuk