如何：在 Visual Basic 中下载文件

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 协议以纯文本方式发送信息（包括密码），因此不应用于传送敏感信息。

另请参阅

• Network
• DownloadFile
• 如何：上传文件
• 如何：分析文件路径