WebClient.DownloadFileTaskAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

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

Overload

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

DownloadFileTaskAsync(String, String)

Sumber:

WebClient.cs

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

public:
 System::Threading::Tasks::Task ^ DownloadFileTaskAsync(System::String ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);

member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task

Public Function DownloadFileTaskAsync (address As String, fileName As String) As Task

Parameter

address

String

URI sumber daya yang akan diunduh.

fileName

String

Nama file yang akan ditempatkan pada komputer lokal.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

InvalidOperationException

File lokal yang ditentukan oleh fileName sedang digunakan oleh utas lain.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task akan selesai setelah sumber daya data diunduh.

Metode ini mengunduh sumber daya di URI yang ditentukan oleh dalam address parameter . Ketika pengunduhan berhasil diselesaikan, file yang diunduh dinamai fileName di komputer lokal. File diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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 menentukan 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 RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Catatan

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

Saat menggunakan metode ini di halaman ASP.NET, Anda akan menerima kesalahan jika akun yang dijalankan halaman tidak memiliki izin untuk mengakses file lokal.

DownloadFileTaskAsync(Uri, String)

Sumber:

WebClient.cs

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

public:
 System::Threading::Tasks::Task ^ DownloadFileTaskAsync(Uri ^ address, System::String ^ fileName);

public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);

member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task

Public Function DownloadFileTaskAsync (address As Uri, fileName As String) As Task

Parameter

address

Uri

URI sumber daya yang akan diunduh.

fileName

String

Nama file yang akan ditempatkan pada komputer lokal.

Mengembalikan

Task

Objek tugas yang mewakili operasi asinkron.

Pengecualian

ArgumentNullException

Parameternya address adalah null.

-atau-

Parameternya fileName adalah null.

WebException

URI yang dibentuk dengan menggabungkan BaseAddress dan address tidak valid.

-atau-

Terjadi kesalahan saat mengunduh sumber daya.

InvalidOperationException

File lokal yang ditentukan oleh fileName sedang digunakan oleh utas lain.

Keterangan

Operasi ini tidak akan memblokir. Objek yang dikembalikan Task akan selesai setelah sumber daya data diunduh.

Metode ini mengunduh sumber daya di URI yang ditentukan oleh dalam address parameter . Ketika pengunduhan berhasil diselesaikan, file yang diunduh dinamai fileName di komputer lokal. File diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas.

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 menentukan 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 RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Catatan

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

Saat menggunakan metode ini di halaman ASP.NET, Anda akan menerima kesalahan jika akun yang dijalankan halaman tidak memiliki izin untuk mengakses file lokal.