My.Computer.Network.UploadFile 方法

项目
08/18/2008

更新：2007 年 11 月

将指定文件发送到指定的主机地址。

' Usage
My.Computer.Network.UploadFile(sourceFileName ,address)
My.Computer.Network.UploadFile(sourceFileName ,address)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password ,showUI ,connectionTimeout)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password ,showUI ,connectionTimeout ,onUserCancel)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password ,showUI ,connectionTimeout)
My.Computer.Network.UploadFile(sourceFileName ,address ,userName ,password ,showUI ,connectionTimeout ,onUserCancel)
My.Computer.Network.UploadFile(sourceFileName ,address ,networkCredentials ,showUI ,connectionTimeout)
My.Computer.Network.UploadFile(sourceFileName ,address ,networkCredentials ,showUI ,connectionTimeout ,onUserCancel)
' Declaration
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As String _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As System.Uri _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As String, _
   ByVal userName As String, _
   ByVal password As String _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As System.Uri, _
   ByVal userName As String, _
   ByVal password As String _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As String, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As System.Uri, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As System.Uri, _
   ByVal userName As String, _
   ByVal password As String, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal onUserCancel As UICancelOption _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As System.Uri, _
   ByVal networkCredentials As System.Net.ICredentials, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer _
)
' -or-
Public Sub UploadFile( _
   ByVal sourceFileName As String, _
   ByVal address As System.Uri, _
   ByVal networkCredentials As System.Net.ICredentials, _
   ByVal showUI As Boolean, _
   ByVal connectionTimeout As Integer, _
   ByVal onUserCancel As UICancelOption _
)

参数

sourceFileName
String。要上载的文件的路径和名称。必选。
address
String 或 Uri。目标服务器的 URL、IP 地址或 URI。必选。
userName
String。要进行身份验证的用户名。默认值为空字符串：""。
password
String。要进行身份验证的密码。默认值为空字符串：""。
showUI
Boolean。是否显示操作进度。默认值为 False。
connectionTimeout
Int32。超时间隔（以毫秒为单位）。默认值为 100 秒。
onUserCancel
UICancelOption。要在用户单击“取消”时进行的操作。默认值为 ThrowException。
networkCredentials
ICredentials。用于身份验证的凭据。

异常

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

本地文件路径无效 (ArgumentException)。
connectionTimeout 小于或等于零 (ArgumentException)。
address 不包括文件名 (InvalidOperationException)。
身份验证失败 (SecurityException)。
用户缺少必要的权限 (SecurityException)。
连接超时 (TimeoutException)。
网站拒绝请求 (WebException)。

备注

如果将 showUI 设置为 True，则将出现一个对话框显示操作的进度，其中包括一个“取消”按钮，用户可单击该按钮取消操作。由于该对话框不是有模式对话框，因此它不会妨碍用户在程序的其他窗口中输入内容。

如果服务器在一定时间间隔（在 connectionTimeout 中指定）内未响应，则会取消操作并引发异常。

如果在应用程序中启用了网络跟踪，My.Computer.Network.UploadFile 将输出跟踪信息。有关更多信息，请参见启用网络跟踪。

安全说明：
FTP 协议会以纯文本方式发送包括密码在内的信息，因此不应该用于传送敏感信息。

任务

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

要执行的操作	请参见
上载文件	如何：在 Visual Basic 中上载文件

示例

此示例将文件 Order.txt 上载到 http://www.cohowinery.com/uploads。

My.Computer.Network.UploadFile ( "C:\My Documents\Order.txt", _
"http://www.cohowinery.com/upload.aspx")

此示例在不提供用户名或密码的情况下将文件 Order.txt 上载到 http://www.cohowinery.com/uploads，显示上载的进度，并且超时间隔为 500 毫秒。

My.Computer.Network.UploadFile ("C:\My Documents\Order.txt", _
"http://www.cohowinery.com/upload.aspx","","",True,500)

要求

命名空间：Microsoft.VisualBasic.Devices

类：Network

**程序集：**Visual Basic 运行库（位于 Microsoft.VisualBasic.dll 中）

按项目类型列出的可用性

项目类型	可用
Windows 应用程序	是
类库	是
控制台应用程序	是
Windows 控件库	是
Web 控件库	是
Windows 服务	是
网站	是

权限

以下权限可能是必需的：

权限	说明
FileIOPermission	控制访问文件和文件夹的能力。关联的枚举：Unrestricted。
UIPermission	控制与用户界面和剪贴板相关的权限。关联的枚举：AllWindows。
WebPermission	控制访问 HTTP Internet 资源的权限。关联的枚举：Unrestricted。