HOW TO：在 Visual Basic 中下載檔案

發行項
08/21/2008

更新：2007 年 11 月

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

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

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

注意事項：
根據您目前使用的設定或版本，您所看到的對話方塊選項，以及功能表命令的名稱和位置，可能會與 [說明] 中描述的不同。撰寫這個說明網頁時已將 [一般開發設定] 納入考慮。若要變更設定，請從 [工具] 功能表中選擇 [匯入和匯出設定]。如需詳細資訊，請參閱 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 通訊協定會以純文字格式傳送資訊 (包括密碼)，因此不應該用於傳輸機密資訊。