Network.DownloadFile Metode

Definisi

Ruang nama:

Microsoft.VisualBasic.Devices

Rakitan:

Microsoft.VisualBasic.Forms.dll

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

TimeoutException

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

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

TimeoutException

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

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

TimeoutException

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

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

TimeoutException

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

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

IOException

overwrite diatur ke False dan file tujuan sudah ada.

TimeoutException

Server tidak merespons dalam yang ditentukan connectionTimeout.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

IOException

overwrite diatur ke False dan file tujuan sudah ada.

TimeoutException

Server tidak merespons dalam yang ditentukan connectionTimeout.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

IOException

overwrite diatur ke False dan file tujuan sudah ada.

TimeoutException

Server tidak merespons dalam yang ditentukan connectionTimeout.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

IOException

overwrite diatur ke False dan file tujuan sudah ada.

TimeoutException

Server tidak merespons dalam yang ditentukan connectionTimeout.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

IOException

overwrite diatur ke False dan file tujuan sudah ada.

TimeoutException

Server tidak merespons dalam yang ditentukan connectionTimeout.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic

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

ArgumentException

destinationFileName diakhir dengan garis miring berikutnya.

IOException

overwrite diatur ke False dan file tujuan sudah ada.

TimeoutException

Server tidak merespons dalam yang ditentukan connectionTimeout.

SecurityException

Pengguna tidak memiliki izin yang diperlukan untuk melakukan operasi jaringan.

WebException

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

• Uri
• ICredentials
• Objek (Visual Basic)
• Cara: Mengunggah File di Visual Basic
• Cara: Mengurai Jalur File di Visual Basic