该方法 DownloadFile 可用于下载远程文件并将其存储到特定位置。 如果将参数 ShowUI
设置为 True
,将显示一个对话框,其中显示下载进度并允许用户取消操作。 默认情况下,不会覆盖具有相同名称的现有文件;如果要覆盖现有文件,请将 overwrite
参数设置为 True
.
以下条件可能会导致异常:
驱动器名称无效(ArgumentException)。
尚未提供必要的身份验证(UnauthorizedAccessException 或 SecurityException)。
服务器未在指定的
connectionTimeout
(TimeoutException) 内响应。网站(WebException)拒绝了请求。
注释
计算机可能会在以下说明中显示某些 Visual Studio 用户界面元素的不同名称或位置。 你拥有的 Visual Studio 版本以及所使用的设置决定了这些元素。 有关更多信息,请参阅 自定义 IDE。
重要
不要根据文件的名称决定文件的内容。 例如,文件Form1.vb可能不是 Visual Basic 源文件。 在应用程序中使用数据之前验证所有输入。 文件的内容可能不是预期内容,从文件读取的方法可能失败。
下载文件
DownloadFile
使用该方法下载文件,将目标文件的位置指定为字符串或 URI,并指定存储文件的位置。 此示例从WineList.txt
中下载文件http://www.cohowinery.com/downloads
并将其保存到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)。 此示例从WineList.txt
下载文件http://www.cohowinery.com/downloads
并保存到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,并指定存储文件的位置、用户名和密码。 使用用户名WineList.txt
和空白密码从http://www.cohowinery.com/downloads
下载文件C:\Documents and Settings\All Users\Documents
并将其保存到anonymous
。My.Computer.Network.DownloadFile( "http://www.cohowinery.com/downloads/WineList.txt", "C:\Documents and Settings\All Users\Documents\WineList.txt", "anonymous", "")
重要
方法使用的
DownLoadFile
FTP 协议以纯文本形式发送信息,包括密码,不应用于传输敏感信息。