在上一篇中介绍的文件上传下载都是基于同步操作.本篇将就异步操作做个总结.
本篇主要总结WebClient类异步上传实现方式和FtpWebRequest类异步上传实现方式,其实明白了异步上传,异步下载就是同样的道理实现.
1.WebClient异步上传
关键知识说明:
WebClient类提供4个异步上传方法,使用方法都是差不多的.
WebClient.UploadDataAsync方法
将数据缓冲区上载到指定的资源
WebClient.UploadFileAsync方法
将指定的本地文件上载到指定的资源
WebClient.UploadStringAsync方法
将指定的字符串上载到指定的资源
WebClient.UploadValuesAsync方法
将指定的名称/值集合上载到指定的资源
其中一个方法签名如下:
public void UploadDataAsync (
Uri address,
string method,
byte[] data,
Object userToken
)
参数
address
接收数据的资源的URI
method
用于将文件发送到资源的HTTP方法。如果为空,则对于http默认值为POST,对于ftp默认值为STOR
data
要发送到资源的数据缓冲
userToken
一个用户定义对象,此对象将被传递给完成异步操作时所调用的方法
若要在数据的上载完成时收到通知,需要实现WebClient.UploadDataCompleted事件,此事件在每次完成异步数据上载操作时引发
总结WebClient异步上传实现步骤:
第一步:定义WebClient,设置各属性
第二步:注册完成事件UploadDataCompleted,以便完成上传时回调
第三步:调用UploadDataAsync方法开始异步上传文件
第四步:上传文件完成回调完成事件UploadDataCompleted定义的方法
实例代码:
把D:/n.txt文件上传到ftp://ftp.dygs2b.com
// 注册完成事件,以便上传完成时,收到通知
request.UploadDataCompleted += new UploadDataCompletedEventHandler ( request_UploadDataCompleted );
string ftpUser = " a " ;
string ftpPassWord = " b " ;
request.Credentials = new NetworkCredential ( ftpUser , ftpPassWord );
FileStream myStream = new FileStream ( @" D:/n.txt " , FileMode.Open , FileAccess.Read );
byte [ ] dataByte = new byte [ myStream.Length ];
myStream.Read ( dataByte , 0 , dataByte.Length ); // 写到2进制数组中
myStream.Close ( );
Uri uri = new Uri ( " ftp://ftp.dygs2b.com/n.txt " );
request.UploadDataAsync ( uri , " STOR " , dataByte , dataByte );
void request_UploadDataCompleted ( object sender , UploadDataCompletedEventArgs e )
{
// 接收UploadDataAsync传递过来的用户定义对象
byte [ ] dataByte = ( byte [ ] ) e.UserState;
// AsyncCompletedEventArgs.Error属性,获取一个值,该值指示异步操作期间发生的错误
if ( e.Error == null )
{
MessageBox.Show ( string .Format ( " 上传成功!文件大小{0} " , dataByte.Length ) );
}
else
{
MessageBox.Show ( e.Error.Message );
}
}
2.FtpWebRequest异步上传
使用FtpWebRequest对象向服务器上载文件,则必须将文件内容写入请求流,同步请求流是通过调用GetRequestStream方法,而异步对应方法是BeginGetRequestStream和EndGetRequestStream方法.
其中BeginGetRequestStream方法签名如下:
public override IAsyncResult BeginGetRequestStream (
AsyncCallback callback,
Object state
)
参数
callback
一个 AsyncCallback 委托,它引用操作完成时要调用的方法
state
一个用户定义对象,其中包含该操作的相关信息。当操作完成时,此对象会被传递给callback委托
必须调用EndGetRequestStream方法用来完成异步操作。通常,EndGetRequestStream由callback所引用的方法调用。
总结FtpWebRequest异步上传实现步骤:
第一步:定义FtpWebRequest,并设置相关属性
第二步:调用FtpWebRequest.BeginGetRequestStream方法,定义操作完成时要调用的方法EndGetResponseCallback,开始以异步方式打开请求的内容流以便写入.
第三步:实现EndGetResponseCallback方法,在此方法中调用FtpWebRequest.EndGetRequestStream方法,结束由BeginGetRequestStream启动的挂起的异步操作,再把本地的文件流数据写到请求流(RequestStream)中,再FtpWebRequest.BeginGetResponse方法,定义操作完成时要调用的方法EndGetResponseCallback,开始以异步方式向FTP服务器发送请求并从FTP服务器接收响应.
第四步:实现EndGetResponseCallback方法,在此方法中调用FtpWebRequest.EndGetResponse方法,结束由BeginGetResponse启动的挂起的异步操作.
实例代码:
把D:/n.txt文件上传到ftp://ftp.dygs2b.com
// 定义FtpWebRequest,并设置相关属性
FtpWebRequest uploadRequest = ( FtpWebRequest ) WebRequest.Create ( uri );
uploadRequest.Method = WebRequestMethods.Ftp.UploadFile;
string ftpUser = " a " ;
string ftpPassWord = " b " ;
uploadRequest.Credentials = new NetworkCredential ( ftpUser , ftpPassWord );
// 开始以异步方式打开请求的内容流以便写入
uploadRequest.BeginGetRequestStream ( new AsyncCallback ( EndGetStreamCallback ) , uploadRequest );
{
// 用户定义对象,其中包含该操作的相关信息,在这里得到FtpWebRequest
FtpWebRequest uploadRequest = ( FtpWebRequest ) ar.AsyncState;
// 结束由BeginGetRequestStream启动的挂起的异步操作
// 必须调用EndGetRequestStream方法来完成异步操作
// 通常EndGetRequestStream由callback所引用的方法调用
Stream requestStream = uploadRequest.EndGetRequestStream ( ar );
FileStream fileStream = File.Open ( @" D:/n.txt " , FileMode.Open );
byte [ ] buffer = new byte [ 1024 ];
int bytesRead;
while ( true )
{
bytesRead = fileStream.Read ( buffer , 0 , buffer.Length );
if ( bytesRead == 0 )
break ;
// 本地的文件流数据写到请求流
requestStream.Write ( buffer , 0 , bytesRead );
}
requestStream.Close ( );
fileStream.Close ( );
// 开始以异步方式向FTP服务器发送请求并从FTP服务器接收响应
uploadRequest.BeginGetResponse ( new AsyncCallback ( EndGetResponseCallback ) , uploadRequest );
}
{
FtpWebRequest uploadRequest = ( FtpWebRequest ) ar.AsyncState;
// 结束由BeginGetResponse启动的挂起的异步操作
FtpWebResponse uploadResponse = ( FtpWebResponse ) uploadRequest.EndGetResponse ( ar );
MessageBox.Show ( uploadResponse.StatusDescription );
MessageBox.Show ( " Upload complete " );
}