WebClient.UploadFileTaskAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas. Metode ini tidak memblokir utas panggilan.

Overload

UploadFileTaskAsync(Uri, String, String)	Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas.
UploadFileTaskAsync(String, String, String)	Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas.
UploadFileTaskAsync(String, String)	Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas.
UploadFileTaskAsync(Uri, String)	Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas.

UploadFileTaskAsync(Uri, String, String)

Sumber:

WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas.

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

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

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

Public Function UploadFileTaskAsync (address As Uri, method As String, fileName As String) As Task(Of Byte())

Parameter

address

Uri

URI sumber daya untuk menerima file. Untuk sumber daya HTTP, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti halaman skrip atau ASP.

method

String

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

fileName

String

File lokal untuk dikirim ke sumber daya.

Mengembalikan

Task<Byte[]>

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

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

fileName adalah null, adalah Empty, berisi karakter yang tidak valid, atau jalur yang ditentukan ke file tidak ada.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah file diunggah ke sumber daya. File dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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 (""), address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Secara default, 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.

UploadFileTaskAsync(String, String, String)

Sumber:

WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas.

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

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

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

Public Function UploadFileTaskAsync (address As String, method As String, fileName As String) As Task(Of Byte())

Parameter

address

String

URI sumber daya untuk menerima file. Untuk sumber daya HTTP, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti halaman skrip atau ASP.

method

String

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

fileName

String

File lokal untuk dikirim ke sumber daya.

Mengembalikan

Task<Byte[]>

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

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

fileName adalah null, adalah Empty, berisi karakter yang tidak valid, atau jalur yang ditentukan ke file tidak ada.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah file diunggah ke sumber daya. File dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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 (""), address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut data yang diminta. QueryString Jika properti bukan string kosong, properti ditambahkan ke address.

Secara default, 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.

UploadFileTaskAsync(String, String)

Sumber:

WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas.

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

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

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

Public Function UploadFileTaskAsync (address As String, fileName As String) As Task(Of Byte())

Parameter

address

String

URI sumber daya untuk menerima file. Untuk sumber daya HTTP, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti halaman skrip atau ASP.

fileName

String

File lokal untuk dikirim ke sumber daya.

Mengembalikan

Task<Byte[]>

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

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

fileName adalah null, adalah Empty, berisi karakter yang tidak valid, atau jalur yang ditentukan ke file tidak ada.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah file diunggah ke sumber daya. File dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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 (""), address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut 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.

UploadFileTaskAsync(Uri, String)

Sumber:

WebClient.cs

Mengunggah file lokal yang ditentukan ke sumber daya sebagai operasi asinkron menggunakan objek tugas.

public:
 System::Threading::Tasks::Task<cli::array <System::Byte> ^> ^ UploadFileTaskAsync(Uri ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task<byte[]> UploadFileTaskAsync (Uri address, string fileName);

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

Public Function UploadFileTaskAsync (address As Uri, fileName As String) As Task(Of Byte())

Parameter

address

Uri

URI sumber daya untuk menerima file. Untuk sumber daya HTTP, URI ini harus mengidentifikasi sumber daya yang dapat menerima permintaan yang dikirim dengan metode POST, seperti halaman skrip atau ASP.

fileName

String

File lokal untuk dikirim ke sumber daya.

Mengembalikan

Task<Byte[]>

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

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

fileName adalah null, adalah Empty, berisi karakter yang tidak valid, atau jalur yang ditentukan ke file tidak ada.

-atau-

Terjadi kesalahan saat membuka aliran.

-atau-

Tidak ada respons dari server yang menghosting sumber daya.

-atau-

Header Content-type dimulai dengan multipart.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task<TResult> akan selesai setelah file diunggah ke sumber daya. File dikirim secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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 (""), address harus merupakan URI relatif yang digabungkan dengan BaseAddress untuk membentuk URI absolut 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.