WebClient.UploadDataTaskAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas. Metode ini tidak memblokir utas panggilan.

Overload

UploadDataTaskAsync(String, Byte[])	Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
UploadDataTaskAsync(Uri, Byte[])	Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
UploadDataTaskAsync(String, String, Byte[])	Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.
UploadDataTaskAsync(Uri, String, Byte[])	Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

UploadDataTaskAsync(String, Byte[])

Sumber:

WebClient.cs

Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, byte[] data);

member this.UploadDataTaskAsync : string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, data As Byte()) As Task(Of Byte())

Parameter

address

String

URI sumber daya untuk menerima data.

data

Byte[]

Buffer data untuk dikirim ke sumber daya.

Mengembalikan

Task<Byte[]>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array Byte yang berisi isi respons yang diterima dari sumber daya saat buffer data diunggah.

Pengecualian

ArgumentNullException

Parameter addressnull.

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

Hati

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

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah buffer data diunggah ke sumber daya.

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.

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 dikombinasikan 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.

UploadDataTaskAsync(Uri, Byte[])

Sumber:

WebClient.cs

Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, byte[] data);

member this.UploadDataTaskAsync : Uri * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, data As Byte()) As Task(Of Byte())

Parameter

address

Uri

URI sumber daya untuk menerima data.

data

Byte[]

Buffer data untuk dikirim ke sumber daya.

Mengembalikan

Task<Byte[]>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array Byte yang berisi isi respons yang diterima dari sumber daya saat buffer data diunggah.

Pengecualian

ArgumentNullException

Parameter addressnull.

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

Hati

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

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah buffer data diunggah ke sumber daya.

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.

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 dikombinasikan 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.

UploadDataTaskAsync(String, String, Byte[])

Sumber:

WebClient.cs

Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(System::String ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (string address, string? method, byte[] data);

member this.UploadDataTaskAsync : string * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As String, method As String, data As Byte()) As Task(Of Byte())

Parameter

address

String

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.

Mengembalikan

Task<Byte[]>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array Byte yang berisi isi respons yang diterima dari sumber daya saat buffer data diunggah.

Pengecualian

ArgumentNullException

Parameter addressnull.

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

Hati

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

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah buffer data diunggah ke sumber daya.

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.

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 dikombinasikan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string 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.

UploadDataTaskAsync(Uri, String, Byte[])

Sumber:

WebClient.cs

Mengunggah buffer data yang berisi array Byte ke URI yang ditentukan sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadDataTaskAsync(Uri ^ address, System::String ^ method, cli::array <System::Byte> ^ data);

public System.Threading.Tasks.Task<byte[]> UploadDataTaskAsync (Uri address, string? method, byte[] data);

member this.UploadDataTaskAsync : Uri * string * byte[] -> System.Threading.Tasks.Task<byte[]>

Public Function UploadDataTaskAsync (address As Uri, method As String, data As Byte()) As Task(Of 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.

Mengembalikan

Task<Byte[]>

Objek tugas yang mewakili operasi asinkron. Properti Result pada objek tugas mengembalikan array Byte yang berisi isi respons yang diterima dari sumber daya saat buffer data diunggah.

Pengecualian

ArgumentNullException

Parameter addressnull.

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

Hati

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

Operasi ini tidak akan memblokir. Objek Task<TResult> yang dikembalikan akan selesai setelah buffer data diunggah ke sumber daya.

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.

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 dikombinasikan dengan BaseAddress untuk membentuk URI absolut data yang diminta. Jika properti QueryString bukan string 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.