WebClient.UploadDataAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI. Metode ini tidak memblokir utas panggilan.

Overload

UploadDataAsync(Uri, String, Byte[])	Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI, menggunakan metode yang ditentukan. Metode ini tidak memblokir utas panggilan.
UploadDataAsync(Uri, String, Byte[], Object)	Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI, menggunakan metode yang ditentukan dan mengidentifikasi token.
UploadDataAsync(Uri, Byte[])	Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI, menggunakan metode POST. Metode ini tidak memblokir utas panggilan.

UploadDataAsync(Uri, String, Byte[])

Sumber:

WebClient.cs

Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI, menggunakan metode yang ditentukan. Metode ini tidak memblokir utas panggilan.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, string? method, byte[] data);

member this.UploadDataAsync : Uri * string * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte())

Parameter

address

Uri

URI sumber daya untuk menerima data.

method

String

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

data

Byte[]

Buffer data untuk dikirim ke sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Metode ini mengirim buffer data ke sumber daya. Buffer data dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Data tidak dikodekan. Untuk menerima pemberitahuan saat pengunggahan data selesai, tambahkan penanganan aktivitas ke UploadDataCompleted acara.

Metode ini tidak memblokir utas panggilan saat data sedang dikirim. Untuk mengirim data dan memblokir sambil menunggu respons server, gunakan salah UploadData satu metode .

Dalam .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 bukan string 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 UploadData(Uri, String, Byte[]).

UploadDataAsync(Uri, String, Byte[], Object)

Sumber:

WebClient.cs

Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI, menggunakan metode yang ditentukan dan mengidentifikasi token.

public:
 void UploadDataAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data, System::Object ^ userToken);

public void UploadDataAsync (Uri address, string? method, byte[] data, object? userToken);

member this.UploadDataAsync : Uri * string * byte[] * obj -> unit

Public Sub UploadDataAsync (address As Uri, method As String, data As Byte(), userToken As Object)

Parameter

address

Uri

URI sumber daya untuk menerima data.

method

String

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

data

Byte[]

Buffer data untuk dikirim ke sumber daya.

userToken

Object

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

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Metode ini mengirim buffer data ke sumber daya. Buffer data dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Data tidak dikodekan. Untuk menerima pemberitahuan saat pengunggahan data selesai, tambahkan penanganan aktivitas ke UploadDataCompleted acara.

Metode ini tidak memblokir utas panggilan saat data sedang dikirim. Untuk mengirim data dan memblokir sambil menunggu respons server, gunakan salah UploadData satu metode .

Dalam .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 bukan string 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.

UploadDataAsync(Uri, Byte[])

Sumber:

WebClient.cs

Mengunggah buffer data ke sumber daya yang diidentifikasi oleh URI, menggunakan metode POST. Metode ini tidak memblokir utas panggilan.

public:
 void UploadDataAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public void UploadDataAsync (Uri address, byte[] data);

member this.UploadDataAsync : Uri * byte[] -> unit

Public Sub UploadDataAsync (address As Uri, data As Byte())

Parameter

address

Uri

URI sumber daya untuk menerima data.

data

Byte[]

Buffer data untuk dikirim ke sumber daya.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

Keterangan

Metode ini mengirim buffer data ke sumber daya. Buffer data dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Data tidak dikodekan. Untuk menerima pemberitahuan saat pengunggahan data selesai, tambahkan penanganan aktivitas ke UploadDataCompleted acara.

Metode ini tidak memblokir utas panggilan saat data sedang dikirim. Untuk mengirim data dan memblokir sambil menunggu respons server, gunakan salah UploadData satu metode .

Dalam .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 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 UploadData(Uri, Byte[]).