WebClient.DownloadFileAsync 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. 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
- Sumber:
- WebClient.cs
- 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
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
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. Untuk menerima pemberitahuan saat file tersedia, tambahkan penanganan aktivitas ke DownloadFileCompleted peristiwa.
Metode ini tidak memblokir utas panggilan saat sumber daya sedang diunduh. Untuk memblokir sambil menunggu pengunduhan selesai, gunakan salah DownloadFile satu metode .
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.
Metode ini disimpan dalam tugas yang menampilkan 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).
Berlaku untuk
DownloadFileAsync(Uri, String, Object)
- Sumber:
- WebClient.cs
- Sumber:
- WebClient.cs
- 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);
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
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
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. Untuk menerima pemberitahuan saat file tersedia, tambahkan penanganan aktivitas ke DownloadFileCompleted peristiwa.
Metode ini tidak memblokir utas panggilan saat sumber daya sedang diunduh. Untuk memblokir sambil menunggu pengunduhan selesai, gunakan salah DownloadFile satu metode .
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