HOW TO：在 Visual Basic 中下載檔案

發行項
02/28/2013

DownloadFile 方法可以用於下載遠端檔案，並存放到特定位置。如果 ShowUI 參數設定為 True，則會顯示對話方塊以顯示下載進度，並允許使用者取消作業。根據預設，不會覆寫具有相同名稱的現有檔案。若要覆寫現有檔案，請將 overwrite 參數設定為 True。

下列情形可能會造成例外狀況 (Exception)：

磁碟名稱無效 (ArgumentException)。
尚未提供必要的驗證 (UnauthorizedAccessException 或 SecurityException)。
伺服器沒有在指定的 connectionTimeout 內回應 (TimeoutException)。
網站拒絕此要求 (WebException)。

注意事項
您的電腦可能會在下列說明中，以不同名稱或位置顯示某些 Visual Studio 使用者介面項目。您所擁有的 Visual Studio 版本以及使用的設定會決定這些項目。如需詳細資訊，請參閱 Visual Studio 設定。

安全性提示
請勿根據檔案名稱來判斷檔案內容。例如，檔案 Form1.vb 可能不是 Visual Basic 原始程式檔。在應用程式中使用這些資料之前，請先驗證所有輸入值。檔案內容可能與預期不同，而且從檔案讀取資料的方法可能會失敗。

下載檔案

請使用 DownloadFile 方法下載檔案，將目標檔案的位置指定為字串或 URI，並指定要存放檔案的位置。這個範例會從 http://www.cohowinery.com/downloads 下載檔案 WineList.txt，並將該檔案儲存到 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")
```

指定逾時間隔以下載檔案

請使用 DownloadFile 方法下載檔案，將目標檔案的位置指定為字串或 URI、指定要存放檔案的位置，並以毫秒為單位指定逾時間隔 (預設值為 1000)。這個範例會從 http://www.cohowinery.com/downloads 下載檔案 WineList.txt，並將該檔案儲存到 C:\Documents and Settings\All Users\Documents，而指定的逾時間隔為 500 毫秒：
```
My.Computer.Network.DownloadFile(
    "http://www.cohowinery.com/downloads/WineList.txt",
    "C:\Documents and Settings\All Users\Documents\WineList.txt", False, 500)
```

提供使用者名稱和密碼以下載檔案

請使用 DownLoadFile 方法下載檔案，將目標檔案的位置指定為字串或 URI，並指定要存放檔案的位置、使用者名稱和密碼。這個範例會以使用者名稱 anonymous 和空白密碼，從 http://www.cohowinery.com/downloads 下載檔案 WineList.txt，並將該檔案儲存到 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", "anonymous", "")
```
安全性提示

DownLoadFile 方法所使用的 FTP 通訊協定會以純文字格式傳送資訊 (包括密碼)，因此不應該用於傳輸機密資訊。

請參閱

工作

HOW TO：在 Visual Basic 中上載檔案

HOW TO：在 Visual Basic 中剖析檔案路徑

參考