WebClient.DownloadFileAsync Metode

Definisi

Ruang nama:

System.Net

Rakitan:

System.Net.WebClient.dll

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

Overload

DownloadFileAsync(Uri, String)	Unduhan, ke file lokal, sumber daya dengan URI yang ditentukan. Metode ini tidak memblokir utas panggilan.
DownloadFileAsync(Uri, String, Object)	Unduhan, ke file lokal, sumber daya dengan URI yang ditentukan. Metode ini tidak memblokir utas panggilan.

DownloadFileAsync(Uri, String)

Sumber:

WebClient.cs

Unduhan, ke file lokal, sumber daya dengan URI yang ditentukan. Metode ini tidak memblokir utas panggilan.

public:
 void DownloadFileAsync(Uri ^ address, System::String ^ fileName);

public void DownloadFileAsync (Uri address, string fileName);

member this.DownloadFileAsync : Uri * string -> unit

Public Sub DownloadFileAsync (address As Uri, fileName As String)

Parameter

address

Uri

URI sumber daya yang akan diunduh.

fileName

String

Nama file yang akan ditempatkan pada komputer lokal.

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter fileNamenull.

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

Hati

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

Metode ini mengunduh sumber daya di URI yang ditentukan oleh dalam parameter address. Ketika pengunduhan berhasil diselesaikan, file yang diunduh diberi nama fileName di komputer lokal. File diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat file tersedia, tambahkan penanganan aktivitas ke peristiwa DownloadFileCompleted.

Metode ini tidak memblokir utas panggilan saat sumber daya sedang diunduh. Untuk memblokir sambil menunggu pengunduhan selesai, gunakan salah satu metode DownloadFile.

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

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing 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.

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 DownloadFile(Uri, String).

DownloadFileAsync(Uri, String, Object)

Sumber:

WebClient.cs

Unduhan, ke file lokal, sumber daya dengan URI yang ditentukan. Metode ini tidak memblokir utas panggilan.

public:
 void DownloadFileAsync(Uri ^ address, System::String ^ fileName, System::Object ^ userToken);

public void DownloadFileAsync (Uri address, string fileName, object? userToken);

member this.DownloadFileAsync : Uri * string * obj -> unit

Public Sub DownloadFileAsync (address As Uri, fileName As String, userToken As Object)

Parameter

address

Uri

URI sumber daya yang akan diunduh.

fileName

String

Nama file yang akan ditempatkan pada komputer lokal.

userToken

Object

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

Pengecualian

ArgumentNullException

Parameter addressnull.

-atau-

Parameter fileNamenull.

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

Hati

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

Metode ini mengunduh sumber daya di URI yang ditentukan oleh dalam parameter address. Ketika pengunduhan berhasil diselesaikan, file yang diunduh diberi nama fileName di komputer lokal. File diunduh secara asinkron menggunakan sumber daya utas yang secara otomatis dialokasikan dari kumpulan utas. Untuk menerima pemberitahuan saat file tersedia, tambahkan penanganan aktivitas ke peristiwa DownloadFileCompleted.

Metode ini tidak memblokir utas panggilan saat sumber daya sedang diunduh. Untuk memblokir sambil menunggu pengunduhan selesai, gunakan salah satu metode DownloadFile.

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

Metode ini menggunakan perintah RETR untuk mengunduh sumber daya FTP. Untuk sumber daya HTTP, metode GET digunakan.

Nota

Anggota ini mengeluarkan informasi pelacakan saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Network Tracing 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.