Share via


Network.DownloadFile Metode

Definisi

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

Overload

DownloadFile(String, String)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(Uri, String)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(String, String, String, String)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(Uri, String, String, String)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

DownloadFile(String, String)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName);
public void DownloadFile (string address, string destinationFileName);
member this.DownloadFile : string * string -> unit
Public Sub DownloadFile (address As String, destinationFileName As String)

Parameter

address
String

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

Server tidak merespons dalam batas waktu default (100 detik).

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika file tujuan sudah ada, DownloadFile metode tidak akan menimpa file yang ada. Anda dapat menggunakan salah satu kelebihan metode lainnya untuk menginstruksikannya DownloadFile untuk menimpa file yang ada, memberikan kredensial pengguna, atau menentukan nilai batas waktu tertentu.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(Uri, String)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName);
public void DownloadFile (Uri address, string destinationFileName);
member this.DownloadFile : Uri * string -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String)

Parameter

address
Uri

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

Server tidak merespons dalam batas waktu default (100 detik).

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika file tujuan sudah ada, DownloadFile metode tidak akan menimpa file yang ada. Anda dapat menggunakan salah satu kelebihan metode lainnya untuk menginstruksikannya DownloadFile untuk menimpa file yang ada, memberikan kredensial pengguna, atau menentukan nilai batas waktu tertentu. DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(String, String, String, String)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);
public void DownloadFile (string address, string destinationFileName, string userName, string password);
member this.DownloadFile : string * string * string * string -> unit
Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)

Parameter

address
String

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

userName
String

Nama pengguna untuk mengautentikasi. Defaultnya adalah string kosong, "".

password
String

Kata sandi untuk mengautentikasi. Defaultnya adalah string kosong, "".

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

Server tidak merespons dalam batas waktu default (100 detik).

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika file tujuan sudah ada, DownloadFile metode tidak akan menimpa file yang ada. Anda dapat menggunakan salah satu kelebihan metode lainnya untuk menginstruksikannya DownloadFile untuk menimpa file yang ada atau menentukan nilai batas waktu tertentu.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Catatan

Protokol FTP mengirimkan informasi, termasuk kata sandi, dalam teks biasa dan tidak boleh digunakan untuk mengirimkan informasi sensitif.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(Uri, String, String, String)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);
public void DownloadFile (Uri address, string destinationFileName, string userName, string password);
member this.DownloadFile : Uri * string * string * string -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)

Parameter

address
Uri

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

userName
String

Nama pengguna untuk mengautentikasi. Defaultnya adalah string kosong, "".

password
String

Kata sandi untuk mengautentikasi. Defaultnya adalah string kosong, "".

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

Server tidak merespons dalam batas waktu default (100 detik).

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika file tujuan sudah ada, DownloadFile metode tidak akan menimpa file yang ada. Anda dapat menggunakan salah satu kelebihan metode lainnya untuk menginstruksikannya DownloadFile untuk menimpa file yang ada atau menentukan nilai batas waktu tertentu.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Catatan

Protokol FTP mengirimkan informasi, termasuk kata sandi, dalam teks biasa dan tidak boleh digunakan untuk mengirimkan informasi sensitif.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite);
public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite);
member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parameter

address
Uri

String atau Uri. Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

String. Nama file dan jalur file yang diunduh.

networkCredentials
ICredentials

ICredentials. Kredensial yang akan disediakan.

showUI
Boolean

True untuk menampilkan kemajuan operasi; jika tidak False. Defaultnya adalah False.

connectionTimeout
Int32

Interval waktu habis, dalam milidetik. Defaultnya adalah 100 detik.

overwrite
Boolean

True untuk menimpa file yang ada; jika tidak False. Defaultnya adalah False.

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

overwrite diatur ke False dan file tujuan sudah ada.

Server tidak merespons dalam yang ditentukan connectionTimeout.

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika showUI diatur ke True, kotak dialog muncul yang memperlihatkan kemajuan operasi; kotak dialog berisi tombol Batal yang dapat digunakan untuk membatalkan operasi. Kotak dialog tidak modal, dan karena itu tidak memblokir input pengguna ke jendela lain dalam program.

Jika server tidak merespons dalam yang ditentukan connectionTimeout, operasi dibatalkan, dan pengecualian dilemparkan.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Catatan

Protokol FTP mengirimkan informasi, termasuk kata sandi, dalam teks biasa dan tidak boleh digunakan untuk mengirimkan informasi sensitif.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);
public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);
member this.DownloadFile : string * string * string * string * bool * int * bool -> unit
Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parameter

address
String

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

userName
String

Nama pengguna untuk mengautentikasi. Defaultnya adalah string kosong, "".

password
String

Kata sandi untuk mengautentikasi. Defaultnya adalah string kosong, "".

showUI
Boolean

True untuk menampilkan kemajuan operasi; jika tidak False. Defaultnya adalah False.

connectionTimeout
Int32

Int32. Interval waktu habis, dalam milidetik. Defaultnya adalah 100 detik.

overwrite
Boolean

True untuk menimpa file yang ada; jika tidak False. Defaultnya adalah False.

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

overwrite diatur ke False dan file tujuan sudah ada.

Server tidak merespons dalam yang ditentukan connectionTimeout.

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika showUI diatur ke True, kotak dialog muncul yang memperlihatkan kemajuan operasi; kotak dialog berisi tombol Batal yang dapat digunakan untuk membatalkan operasi. Kotak dialog tidak modal, dan karena itu tidak memblokir input pengguna ke jendela lain dalam program.

Jika server tidak merespons dalam yang ditentukan connectionTimeout, operasi dibatalkan, dan pengecualian dilemparkan.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Catatan

Protokol FTP mengirimkan informasi, termasuk kata sandi, dalam teks biasa dan tidak boleh digunakan untuk mengirimkan informasi sensitif.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parameter

address
Uri

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

networkCredentials
ICredentials

Kredensial yang akan disediakan.

showUI
Boolean

True untuk menampilkan kemajuan operasi; jika tidak False. Defaultnya adalah False.

connectionTimeout
Int32

Interval waktu habis, dalam milidetik. Defaultnya adalah 100 detik.

overwrite
Boolean

True untuk menimpa file yang ada; jika tidak False. Defaultnya adalah False.

onUserCancel
UICancelOption

Menentukan perilaku saat pengguna mengklik Batal atau Tidak pada kotak dialog yang diperlihatkan sebagai hasil dari showUI diatur ke True. Defaultnya adalah ThrowException.

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

overwrite diatur ke False dan file tujuan sudah ada.

Server tidak merespons dalam yang ditentukan connectionTimeout.

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika showUI diatur ke True, kotak dialog muncul yang memperlihatkan kemajuan operasi; kotak dialog berisi tombol Batal yang dapat digunakan untuk membatalkan operasi. Kotak dialog tidak modal, dan karena itu tidak memblokir input pengguna ke jendela lain dalam program.

Jika server tidak merespons dalam yang ditentukan connectionTimeout, operasi dibatalkan, dan pengecualian dilemparkan.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Catatan

Protokol FTP mengirimkan informasi, termasuk kata sandi, dalam teks biasa dan tidak boleh digunakan untuk mengirimkan informasi sensitif.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);
public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);
member this.DownloadFile : Uri * string * string * string * bool * int * bool -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

Parameter

address
Uri

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

userName
String

Nama pengguna untuk mengautentikasi. Defaultnya adalah string kosong, "".

password
String

Kata sandi untuk mengautentikasi. Defaultnya adalah string kosong, "".

showUI
Boolean

True untuk menampilkan kemajuan operasi; jika tidak False. Defaultnya adalah False.

connectionTimeout
Int32

Interval waktu habis, dalam milidetik. Defaultnya adalah 100 detik.

overwrite
Boolean

True untuk menimpa file yang ada; jika tidak False. Defaultnya adalah False.

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

overwrite diatur ke False dan file tujuan sudah ada.

Server tidak merespons dalam yang ditentukan connectionTimeout.

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika showUI diatur ke True, kotak dialog muncul yang memperlihatkan kemajuan operasi; kotak dialog berisi tombol Batal yang dapat digunakan untuk membatalkan operasi. Kotak dialog tidak modal, dan karena itu tidak memblokir input pengguna ke jendela lain dalam program.

Jika server tidak merespons dalam yang ditentukan connectionTimeout, operasi dibatalkan, dan pengecualian dilemparkan.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Catatan

Protokol FTP mengirimkan informasi, termasuk kata sandi, dalam teks biasa dan tidak boleh digunakan untuk mengirimkan informasi sensitif.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.DownloadFile : string * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parameter

address
String

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

userName
String

Nama pengguna untuk mengautentikasi. Defaultnya adalah string kosong, "".

password
String

Kata sandi untuk mengautentikasi. Defaultnya adalah string kosong, "".

showUI
Boolean

True untuk menampilkan kemajuan operasi; jika tidak False. Defaultnya adalah False.

connectionTimeout
Int32

Interval waktu habis, dalam milidetik. Defaultnya adalah 100 detik.

overwrite
Boolean

True untuk menimpa file yang ada; jika tidak False. Defaultnya adalah False.

onUserCancel
UICancelOption

Menentukan perilaku saat pengguna mengklik Batal atau Tidak pada kotak dialog yang diperlihatkan sebagai hasil dari ShowUI diatur ke True. Defaultnya adalah ThrowException.

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

overwrite diatur ke False dan file tujuan sudah ada.

Server tidak merespons dalam yang ditentukan connectionTimeout.

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika showUI diatur ke True, kotak dialog muncul yang memperlihatkan kemajuan operasi; kotak dialog berisi tombol Batal yang dapat digunakan untuk membatalkan operasi. Kotak dialog tidak modal, dan karena itu tidak memblokir input pengguna ke jendela lain dalam program.

Jika server tidak merespons dalam yang ditentukan connectionTimeout, operasi dibatalkan, dan pengecualian dilemparkan.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Catatan

Protokol FTP mengirimkan informasi, termasuk kata sandi, dalam teks biasa dan tidak boleh digunakan untuk mengirimkan informasi sensitif.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

Mengunduh file jarak jauh yang ditentukan dan menyimpannya di lokasi yang ditentukan.

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);
public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);
member this.DownloadFile : Uri * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit
Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

Parameter

address
Uri

Jalur file yang akan diunduh, termasuk nama file dan alamat host.

destinationFileName
String

Nama file dan jalur file yang diunduh.

userName
String

Nama pengguna untuk mengautentikasi. Defaultnya adalah string kosong, "".

password
String

Kata sandi untuk mengautentikasi. Defaultnya adalah string kosong, "".

showUI
Boolean

True untuk menampilkan kemajuan operasi; jika tidak False. Defaultnya adalah False.

connectionTimeout
Int32

Interval waktu habis, dalam milidetik. Defaultnya adalah 100 detik.

overwrite
Boolean

True untuk menimpa file yang ada; jika tidak False. Defaultnya adalah False.

onUserCancel
UICancelOption

Menentukan perilaku saat pengguna mengklik Batal atau Tidak pada kotak dialog yang diperlihatkan sebagai hasil dari ShowUI diatur ke True. Defaultnya adalah ThrowException.

Pengecualian

destinationFileName diakhir dengan garis miring berikutnya.

overwrite diatur ke False dan file tujuan sudah ada.

Server tidak merespons dalam yang ditentukan connectionTimeout.

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

Permintaan ditolak oleh server web target.

Contoh

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/WineList.txt", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt")

Contoh ini mengunduh file WineList.txt dari http://www.cohowinery.com/downloads dan menyimpannya ke C:\Documents and Settings\All Users\Documents, menentukan interval batas waktu 500 milidetik.

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

Keterangan

Jika showUI diatur ke True, kotak dialog muncul yang memperlihatkan kemajuan operasi; kotak dialog berisi tombol Batal yang dapat digunakan untuk membatalkan operasi. Kotak dialog tidak modal, dan karena itu tidak memblokir input pengguna ke jendela lain dalam program.

Jika server tidak merespons dalam yang ditentukan connectionTimeout, operasi dibatalkan, dan pengecualian dilemparkan.

DownloadFile output melacak informasi saat Anda mengaktifkan pelacakan jaringan di aplikasi Anda. Untuk informasi selengkapnya, lihat Mengaktifkan Pelacakan Jaringan.

Catatan

Metode DownloadFile ini tidak mengirim header HTTP opsional. Beberapa server mungkin mengembalikan 500 (Kesalahan Server Internal) jika header agen pengguna opsional hilang. Untuk mengirim header opsional, Anda harus membuat permintaan menggunakan WebClient kelas .

Catatan

Protokol FTP mengirimkan informasi, termasuk kata sandi, dalam teks biasa dan tidak boleh digunakan untuk mengirimkan informasi sensitif.

Tabel berikut ini mencantumkan contoh tugas yang melibatkan My.Computer.Network.DownloadFile metode .

Untuk Lihat
Unduh file Cara: Mengunduh Berkas

Lihat juga

Berlaku untuk