WebClient.DownloadFileTaskAsync Metode
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Sumber:
- WebClient.cs
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (string address, string fileName);
member this.DownloadFileTaskAsync : string * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objek tugas yang mewakili operasi asinkron.
- Atribut
Pengecualian
URI yang dibentuk dengan menggabungkan BaseAddress dan address
tidak valid.
-atau-
Terjadi kesalahan saat mengunduh sumber daya.
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.
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 ("") 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 di bawah tidak memiliki izin untuk mengakses file lokal.
Berlaku untuk
DownloadFileTaskAsync(Uri, String)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- 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);
[System.Runtime.InteropServices.ComVisible(false)]
public System.Threading.Tasks.Task DownloadFileTaskAsync (Uri address, string fileName);
member this.DownloadFileTaskAsync : Uri * string -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
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
Objek tugas yang mewakili operasi asinkron.
- Atribut
Pengecualian
URI yang dibentuk dengan menggabungkan BaseAddress dan address
tidak valid.
-atau-
Terjadi kesalahan saat mengunduh sumber daya.
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.
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 ("") 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 di bawah tidak memiliki izin untuk mengakses file lokal.
Berlaku untuk
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk