Network.DownloadFile 方法

定义

命名空间:

Microsoft.VisualBasic.Devices

程序集:

Microsoft.VisualBasic.Forms.dll

下载指定的远程文件，并将其保存到指定位置。

重载

DownloadFile(String, String)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(Uri, String)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(String, String, String, String)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(Uri, String, String, String)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(String, String, String, String, Boolean, Int32, Boolean)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)	下载指定的远程文件，并将其保存到指定位置。
DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)	下载指定的远程文件，并将其保存到指定位置。

DownloadFile(String, String)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName);

public void DownloadFile (string address, string destinationFileName);

member this.DownloadFile : string * string -> unit

Public Sub DownloadFile (address As String, destinationFileName As String)

参数

address

String

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

TimeoutException

服务器没有在指定的默认超时（100 秒）内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果目标文件已存在，则 DownloadFile 方法不会覆盖现有文件。 可以使用 方法的其他重载 DownloadFile 之一来指示它覆盖现有文件、提供用户凭据或指定特定的超时值。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(Uri, String)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName);

public void DownloadFile (Uri address, string destinationFileName);

member this.DownloadFile : Uri * string -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String)

参数

address

Uri

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

TimeoutException

服务器没有在指定的默认超时（100 秒）内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果目标文件已存在，则 DownloadFile 方法不会覆盖现有文件。 可以使用 方法的其他重载 DownloadFile 之一来指示它覆盖现有文件、提供用户凭据或指定特定的超时值。 DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(String, String, String, String)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);

public void DownloadFile (string address, string destinationFileName, string userName, string password);

member this.DownloadFile : string * string * string * string -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String)

参数

address

String

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

userName

String

要进行身份验证的用户名。 默认值为空字符串 ""。

password

String

要进行身份验证的密码。 默认值为空字符串 ""。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

TimeoutException

服务器没有在指定的默认超时（100 秒）内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果目标文件已存在，则 DownloadFile 方法不会覆盖现有文件。 可以使用 方法的其他重载 DownloadFile 之一来指示它覆盖现有文件或指定特定的超时值。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

注意

FTP 协议以纯文本形式发送信息（包括密码），不应用于传输敏感信息。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(Uri, String, String, String)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password);

member this.DownloadFile : Uri * string * string * string -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String)

参数

address

Uri

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

userName

String

要进行身份验证的用户名。 默认值为空字符串 ""。

password

String

要进行身份验证的密码。 默认值为空字符串 ""。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

TimeoutException

服务器没有在指定的默认超时（100 秒）内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果目标文件已存在，则 DownloadFile 方法不会覆盖现有文件。 可以使用 方法的其他重载 DownloadFile 之一来指示它覆盖现有文件或指定特定的超时值。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

注意

FTP 协议以纯文本形式发送信息（包括密码），不应用于传输敏感信息。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

参数

address

Uri

String 或 Uri。 要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

String. 下载的文件的文件名和路径。

networkCredentials

ICredentials

ICredentials. 要提供的凭据。

showUI

Boolean

要显示操作进度，则为 True；否则为 False。 默认值为 False。

connectionTimeout

Int32

以毫秒为单位的超时间隔。 默认值为 100 秒。

overwrite

Boolean

要覆盖现有文件，则为 True；否则为 False。 默认值为 False。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

IOException

将 overwrite 设置为 False，而目标文件已存在。

TimeoutException

服务器没有在指定的 connectionTimeout 内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果 showUI 设置为 True，则会出现一个对话框，显示操作进度;该对话框包含可用于取消操作的“ 取消 ”按钮。 对话框不是模式对话框，因此不会阻止用户输入程序中的其他窗口。

如果服务器在指定的 connectionTimeout中未响应，则会取消该操作，并引发异常。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

注意

FTP 协议以纯文本形式发送信息（包括密码），不应用于传输敏感信息。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(String, String, String, String, Boolean, Int32, Boolean)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : string * string * string * string * bool * int * bool -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

参数

address

String

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

userName

String

要进行身份验证的用户名。 默认值为空字符串 ""。

password

String

要进行身份验证的密码。 默认值为空字符串 ""。

showUI

Boolean

要显示操作进度，则为 True；否则为 False。 默认值为 False。

connectionTimeout

Int32

Int32. 以毫秒为单位的超时间隔。 默认值为 100 秒。

overwrite

Boolean

要覆盖现有文件，则为 True；否则为 False。 默认值为 False。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

IOException

将 overwrite 设置为 False，而目标文件已存在。

TimeoutException

服务器没有在指定的 connectionTimeout 内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果 showUI 设置为 True，则会出现一个对话框，显示操作进度;该对话框包含可用于取消操作的“ 取消 ”按钮。 对话框不是模式对话框，因此不会阻止用户输入程序中的其他窗口。

如果服务器在指定的 connectionTimeout中未响应，则会取消该操作，并引发异常。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

注意

FTP 协议以纯文本形式发送信息（包括密码），不应用于传输敏感信息。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(Uri, String, ICredentials, Boolean, Int32, Boolean, UICancelOption)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::Net::ICredentials ^ networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (Uri address, string destinationFileName, System.Net.ICredentials networkCredentials, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : Uri * string * System.Net.ICredentials * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, networkCredentials As ICredentials, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

参数

address

Uri

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

networkCredentials

ICredentials

要提供的凭据。

showUI

Boolean

要显示操作进度，则为 True；否则为 False。 默认值为 False。

connectionTimeout

Int32

以毫秒为单位的超时间隔。 默认值为 100 秒。

overwrite

Boolean

要覆盖现有文件，则为 True；否则为 False。 默认值为 False。

onUserCancel

UICancelOption

指定当用户在对话框（在 showUI 设置为 True 时将显示此对话框）上单击“取消”或“否”时的行为。 默认值为 ThrowException。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

IOException

将 overwrite 设置为 False，而目标文件已存在。

TimeoutException

服务器没有在指定的 connectionTimeout 内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果 showUI 设置为 True，则会出现一个对话框，显示操作进度;该对话框包含可用于取消操作的“ 取消 ”按钮。 对话框不是模式对话框，因此不会阻止用户输入程序中的其他窗口。

如果服务器在指定的 connectionTimeout中未响应，则会取消该操作，并引发异常。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

注意

FTP 协议以纯文本形式发送信息（包括密码），不应用于传输敏感信息。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite);

member this.DownloadFile : Uri * string * string * string * bool * int * bool -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean)

参数

address

Uri

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

userName

String

要进行身份验证的用户名。 默认值为空字符串 ""。

password

String

要进行身份验证的密码。 默认值为空字符串 ""。

showUI

Boolean

要显示操作进度，则为 True；否则为 False。 默认值为 False。

connectionTimeout

Int32

以毫秒为单位的超时间隔。 默认值为 100 秒。

overwrite

Boolean

要覆盖现有文件，则为 True；否则为 False。 默认值为 False。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

IOException

将 overwrite 设置为 False，而目标文件已存在。

TimeoutException

服务器没有在指定的 connectionTimeout 内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果 showUI 设置为 True，则会出现一个对话框，显示操作进度;该对话框包含可用于取消操作的“ 取消 ”按钮。 对话框不是模式对话框，因此不会阻止用户输入程序中的其他窗口。

如果服务器在指定的 connectionTimeout中未响应，则会取消该操作，并引发异常。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

注意

FTP 协议以纯文本形式发送信息（包括密码），不应用于传输敏感信息。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(String, String, String, String, Boolean, Int32, Boolean, UICancelOption)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(System::String ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (string address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : string * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As String, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

参数

address

String

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

userName

String

要进行身份验证的用户名。 默认值为空字符串 ""。

password

String

要进行身份验证的密码。 默认值为空字符串 ""。

showUI

Boolean

要显示操作进度，则为 True；否则为 False。 默认值为 False。

connectionTimeout

Int32

以毫秒为单位的超时间隔。 默认值为 100 秒。

overwrite

Boolean

要覆盖现有文件，则为 True；否则为 False。 默认值为 False。

onUserCancel

UICancelOption

指定当用户在对话框（在 ShowUI 设置为 True 时将显示此对话框）上单击“取消”或“否”时的行为。 默认值为 ThrowException。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

IOException

将 overwrite 设置为 False，而目标文件已存在。

TimeoutException

服务器没有在指定的 connectionTimeout 内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果 showUI 设置为 True，则会出现一个对话框，显示操作进度;该对话框包含可用于取消操作的“ 取消 ”按钮。 对话框不是模式对话框，因此不会阻止用户输入程序中的其他窗口。

如果服务器在指定的 connectionTimeout中未响应，则会取消该操作，并引发异常。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

注意

FTP 协议以纯文本形式发送信息（包括密码），不应用于传输敏感信息。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径

DownloadFile(Uri, String, String, String, Boolean, Int32, Boolean, UICancelOption)

下载指定的远程文件，并将其保存到指定位置。

public:
 void DownloadFile(Uri ^ address, System::String ^ destinationFileName, System::String ^ userName, System::String ^ password, bool showUI, int connectionTimeout, bool overwrite, Microsoft::VisualBasic::FileIO::UICancelOption onUserCancel);

public void DownloadFile (Uri address, string destinationFileName, string userName, string password, bool showUI, int connectionTimeout, bool overwrite, Microsoft.VisualBasic.FileIO.UICancelOption onUserCancel);

member this.DownloadFile : Uri * string * string * string * bool * int * bool * Microsoft.VisualBasic.FileIO.UICancelOption -> unit

Public Sub DownloadFile (address As Uri, destinationFileName As String, userName As String, password As String, showUI As Boolean, connectionTimeout As Integer, overwrite As Boolean, onUserCancel As UICancelOption)

参数

address

Uri

要下载的文件的路径，包括文件名和主机地址。

destinationFileName

String

下载的文件的文件名和路径。

userName

String

要进行身份验证的用户名。 默认值为空字符串 ""。

password

String

要进行身份验证的密码。 默认值为空字符串 ""。

showUI

Boolean

要显示操作进度，则为 True；否则为 False。 默认值为 False。

connectionTimeout

Int32

以毫秒为单位的超时间隔。 默认值为 100 秒。

overwrite

Boolean

要覆盖现有文件，则为 True；否则为 False。 默认值为 False。

onUserCancel

UICancelOption

指定当用户在对话框（在 ShowUI 设置为 True 时将显示此对话框）上单击“取消”或“否”时的行为。 默认值为 ThrowException。

例外

ArgumentException

destinationFileName 以尾随斜杠结尾。

IOException

将 overwrite 设置为 False，而目标文件已存在。

TimeoutException

服务器没有在指定的 connectionTimeout 内响应。

SecurityException

用户缺少必要的权限，无法执行网络操作。

WebException

请求被目标 Web 服务器拒绝。

示例

本示例从 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")

本示例从 http://www.cohowinery.com/downloads 下载文件WineList.txt并将其保存到 C:\Documents and Settings\All Users\Documents，指定超时间隔为 500 毫秒。

My.Computer.Network.DownloadFile(
  "http://www.cohowinery.com/downloads/", 
  "C:\Documents and Settings\All Users\Documents\WineList.txt", 
  "", "", False, 500, True)

注解

如果 showUI 设置为 True，则会出现一个对话框，显示操作进度;该对话框包含可用于取消操作的“ 取消 ”按钮。 对话框不是模式对话框，因此不会阻止用户输入程序中的其他窗口。

如果服务器在指定的 connectionTimeout中未响应，则会取消该操作，并引发异常。

DownloadFile 在应用程序中启用网络跟踪时，输出跟踪信息。 有关详细信息，请参阅 启用网络跟踪。

注意

方法 DownloadFile 不发送可选的 HTTP 标头。 如果缺少可选的用户代理标头，某些服务器可能会返回 500 (内部服务器错误) 。 若要发送可选标头，必须使用 类构造请求 WebClient 。

注意

FTP 协议以纯文本形式发送信息（包括密码），不应用于传输敏感信息。

下表列出了涉及 My.Computer.Network.DownloadFile 方法的任务示例。

功能	查看
下载文件	如何：下载文件

另请参阅

• Uri
• ICredentials
• 对象 (Visual Basic)
• 如何：在 Visual Basic 中下载文件
• 如何：在 Visual Basic 中分析文件路径