一、什么是WebClient类
1、基本知识
WebClient类是Mircsoft在.NET框架下提供的向 URI 标识的资源发送数据和从 URI 标识的资源接收数据的公共方法。通过这个类,大家可以在脱离浏览器的基础上模拟浏览器对互联网上的资源的访问和发送信息。它使人们使用起来更加简单方便,然而它也有先天不足的地方。那就是缺少对cookies/session的支持。
WebClient类为Silverlight插件提供了一整套的HTTP客户端功能,可以下载应用程序数据,比如XAML内容,附加的程序集或者视频图片等媒体文件。WebClient可以根据程序须要即时下载内容,可以异步呈现和使用下载的内容,而不是随HTML页面一起下载。
WebClient类提供了发起请求、监视请求的进度以及检索下载内容、上传数据到指定资源等功能。在Silverlight 2中,只能使用WebClient发起异步的请求,如开发一个视频播放应用程序,在应用程序加载时,选择开始请求每一部影片,使其加载到浏览器缓存中,这样可以避免缓冲延迟。
由于WebClient请求都是异步的,使用的是基于异步事件编程模型,大部分交互操作都是依靠事件处理来完成的,通常须要定义如下一个或者多个事件处理函数。
2、相关方法
将数据上载到资源的 WebClient 方法
UploadStringAsync: 在不阻止调用线程的情况下,将 String 发送到资源。
从资源下载数据的 WebClient 方法
OpenReadAsync : 在不阻止调用线程的情况下,以异步方式从资源返回数据。
您可以使用 CancelAsync 方法取消尚未完成的异步操作。
3、两种工作方式:
A、以字符串形式下载和上传数据
使用WebClient可以以字符串形式下载数据,当请求一个指定地址的字符串时,调用DownloadStringAsync方法,操作完成后将触发DownloadStringCompleted事件,在该事件处理方法中能够接收到一个类型为DownloadStringCompletedEventArgs的参数,它的Result属性的类型为String,我们可以通过该属性来获得最终的字符串结果,它可以是一段普通的文本或一段XML文本等。
B、 以流形式下载和上传数据
使用WebClient同样可以以流形式下载数据,当请求下载的资源是一个流时,可调用OpenReadAsync方法,此操作完成后将触发OpenReadCompleted事件,在该事件处理方法中能够接收到一个类型为OpenReadCompletedEventArgs的参数,它的Result属性类型为Stream,使用此属性能够获取到最终的流结果。
二、示例如何实现通讯 (以字符串形式下载和上传数据)
新建Silverlight应用程序SLWebClient。如下图:
编写界面布局,XAML如下:
界面如下图:
在客户端,我们要完成两段代码:
i、向服务器端发出"下载字符串"请求,相关代码如下:
ii、向服务器端发出"上传字符串"请求,相关代码如下:
private void btnUploadText_Click(object sender, RoutedEventArgs e)
{
// 要上传的文本数据
string data = this.txtBxUploadStr.Text.ToString();
Uri endpoint = new Uri("http://localhost:49417/WebClientUpLoadHandler.ashx");
WebClient client = new WebClient();
client.UploadStringCompleted +=
new UploadStringCompletedEventHandler(client_UploadStringCompleted);
client.UploadStringAsync(endpoint, "POST", data);
}
void client_UploadStringCompleted(object sender,UploadStringCompletedEventArgs e)
{
MessageBox.Show(e.Result);
}
#endregion
Page.xaml.cs全部代码如下:
在服务器端,我们要建立两个Handler
WebClientUpLoadHandler.ashx :处理客户端的上传请求
WebClientDownHandler.ashx --负责处理下载字符串请求的Handler代码如下:
WebClientUpLoadHandler.ashx--负责处理上传字符串请求的Handler代码如下:
生成应用程序并运行,运行效果如下: