关于使用VB.NET上传Network.UploadFile方法

最新推荐文章于 2025-08-09 21:46:46 发布

原创最新推荐文章于 2025-08-09 21:46:46 发布 · 398 阅读

4 ·

CC 4.0 BY-SA版权

文章标签：

#.net #服务器 #网络

项目摘要：

本项目涉及使用Microsoft.VisualBasic.Devices命名空间中的UploadFile方法，通过Microsoft.VisualBasic.Forms.dll程序集实现文件上传功能。

该方法支持多种重载形式，允许用户指定文件路径、目标地址、用户名、密码等参数，并可选择是否显示上传进度、设置超时时间及处理用户取消操作。

例如，可以将本地文件Order.txt上传至指定URL，并可选择是否显示进度条及设置超时时间。需要注意的是，FTP协议传输信息时未加密，因此不适用于传输敏感数据。

此外，方法还提供了异常处理机制，如超时、权限不足等情况会抛出相应异常。

定义
命名空间:
Microsoft.VisualBasic.Devices
程序集:
Microsoft.VisualBasic.Forms.dll
将指定的文件发送到指定的主机地址。

UploadFile(String, String, String, String, Boolean, Int32, UICancelOption)	
将指定的文件发送到指定的主机地址。

UploadFile(String, String)	
将指定的文件发送到指定的主机地址。

UploadFile(String, Uri)	
将指定的文件发送到指定的主机地址。

UploadFile(String, String, String, String)	
将指定的文件发送到指定的主机地址。

UploadFile(String, Uri, String, String)	
将指定的文件发送到指定的主机地址。

UploadFile(String, Uri, ICredentials, Boolean, Int32)	
将指定的文件发送到指定的主机地址。

UploadFile(String, String, String, String, Boolean, Int32)	
将指定的文件发送到指定的主机地址。

UploadFile(String, Uri, ICredentials, Boolean, Int32, UICancelOption)	
将指定的文件发送到指定的主机地址。

UploadFile(String, Uri, String, String, Boolean, Int32)	
将指定的文件发送到指定的主机地址。

UploadFile(String, Uri, String, String, Boolean, Int32, UICancelOption)	
将指定的文件发送到指定的主机地址。

UploadFile(String, String, String, String, Boolean, Int32, UICancelOption)
将指定的文件发送到指定的主机地址。

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

参数
sourceFileName
String
要上载的文件的路径和名称。

address
String
目标服务器的 URL、IP 地址或 URI。

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

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

showUI
Boolean
是否显示操作进度。默认值为 False。

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

onUserCancel
UICancelOption
当用户单击“取消”时要采取的操作。默认值为 ThrowException。

例外
ArgumentException
connectionTimeout 小于或等于零。

InvalidOperationException
address不包括文件名。

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

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

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

示例
此示例将文件 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)

注解
如果 showUI 设置为 True，则对话框将显示操作进度，并包含用户可单击以取消操作的“ 取消 ”按钮。由于对话框不是模式对话框，因此它不会阻止用户输入程序中的其他窗口。

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

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

备注

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