WebClient.UploadValuesAsync 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.
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
untuk NameValueCollection mengirim ke sumber daya.
Pengecualian
URI yang dibentuk dengan menggabungkan BaseAddress dan address
tidak valid.
-atau-
Tidak ada respons dari server yang menghosting sumber daya.
Keterangan
Metode ini mengirimkan 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 menjadi Byte array menggunakan pengodean yang ditentukan dalam Encoding properti . Untuk menerima pemberitahuan saat unggahan string selesai, Anda dapat menambahkan penanganan aktivitas ke UploadStringCompleted peristiwa.
Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok saat menunggu respons server, gunakan salah UploadString satu metode .
Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address
.
Metode ini menggunakan perintah STOR untuk mengunggah sumber daya FTP. Untuk sumber daya HTTP, metode POST digunakan.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan 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 method
metode .
- method
- String
Metode yang digunakan untuk mengirim string ke sumber daya. Jika null, defaultnya adalah POST untuk http dan STOR untuk ftp.
- data
- NameValueCollection
untuk NameValueCollection mengirim ke sumber daya.
Pengecualian
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
Metode ini mengirimkan data yang terkandung dalam sumber NameValueCollectionaddress
daya. Gunakan metode ini untuk mengirim data formulir ke URI untuk diproses. Data dikirim menggunakan jenis media form-urlencoded; nilai header Content-Type harus diatur ke "application/x-www-form-urlencoded". Header diatur dengan benar secara default. Metode UploadValuesAsync melempar WebException jika Anda memanggil metode ini dengan nilai header Jenis Konten yang berbeda yang diatur dalam Headers koleksi.
method
Jika metode tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, dilemparkan WebException dengan properti yang 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 UploadValuesCompleted peristiwa.
Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok saat menunggu respons server, gunakan salah UploadValues satu metode .
Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang dikombinasikan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti tidak kosong, properti ditambahkan ke address
.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan 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 method
metode .
- 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
untuk NameValueCollection mengirim ke sumber daya.
- userToken
- Object
Objek yang ditentukan pengguna yang diteruskan ke metode yang dipanggil saat operasi asinkron selesai.
Pengecualian
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
Metode ini mengirim data yang terkandung dalam sumber NameValueCollectionaddress
daya. Gunakan metode ini untuk mengirim data formulir ke URI untuk diproses. Data dikirim menggunakan jenis media form-urlencoded; nilai header Content-Type harus diatur ke "application/x-www-form-urlencoded". Header diatur dengan benar secara default. Metode melempar UploadValuesAsyncWebException jika Anda memanggil metode ini dengan nilai header Jenis Konten yang berbeda yang diatur dalam Headers koleksi.
method
Jika metode tidak dipahami oleh server, kelas protokol yang mendasar menentukan apa yang terjadi. Biasanya, dilemparkan WebException dengan properti yang 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 UploadValuesCompleted peristiwa.
Metode ini tidak memblokir utas panggilan saat string sedang dikirim. Untuk mengirim string dan blok sambil menunggu respons server, gunakan salah UploadValues satu metode.
Di .NET Framework dan .NET Core 1.0, Anda dapat membatalkan operasi asinkron yang belum selesai dengan memanggil CancelAsync metode .
BaseAddress Jika properti bukan string kosong ("") dan address
tidak berisi URI absolut, address
harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut dari data yang diminta. QueryString Jika properti tidak kosong, properti ditambahkan ke address
.
Catatan
Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Pelacakan Jaringan di .NET Framework.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk