如何：在 Visual Basic 中下载文件

项目
04/07/2023

DownloadFile 方法可用来下载远程文件并将其存储到特定位置。如果 ShowUI 参数设置为 True，则显示一个对话框，该对话框显示下载进度并允许用户取消该操作。默认情况下，不会覆盖同名的现有文件；如果希望覆盖现有文件，则将 overwrite 参数设为 True。

以下情况可能会导致异常：

驱动器名称无效 (ArgumentException)。
尚未提供必要的身份验证（UnauthorizedAccessException 或 SecurityException）。
服务器未在指定的 connectionTimeout (TimeoutException) 内响应。
请求被网站 (WebException) 拒绝。

注意

以下说明中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。这些元素取决于你所使用的 Visual Studio 版本和你所使用的设置。有关详细信息，请参阅个性化设置 IDE。

重要

不要根据文件的名称来判断文件的内容。例如，文件 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 协议以纯文本方式发送信息（包括密码），因此不应用于传送敏感信息。

另请参阅