Silverlight 2学习教程(七):在Silverlight 2.0中制作资源加载进度条

Silverlight 2.0去掉了原来的downloader对象,代之以WebClient对象。WebClient类为Silverlight插件提供了一整套的HTTP客户端功能。可以下载应用程序数据,比如XAML内容,附加的程序集或者诸如图片的媒体文件。WebClient类可以根据程序的需要下载内容,可以异步呈现或者利用下载的内容,而不是随HTML页面一起下载。如果你要按照一定的序列替换Silverlight内容,不需要刷新页面。比较常见的来自是从视频库中播放视频,但本节是以播放图片为例子的。

关于WebClient

WebClient请求是异步的,大部分的交互操作都是依靠事件处理器来完成的。通常,需要定义如下中的一个或者多个处理器函数。

■ DownloadStringCompleted ■ OpenReadCompleted ■ DownloadProgressChanged

根据你请求的资源是字符串还是流,需要使用不同的API,当请求一个字符串时,可以调用下面的方法:

■ DownloadStringAsync(Uri) ■ DownloadStringAsync(Uri, Object)

然后再处理DownloadStringCompleted事件。

当请求的是一个流时,可以调用下面的方法:

■ OpenReadAsync(Uri) ■ OpenReadAsync(Uri, Object)

然后处理OpenReadCompleted事件。

OpenReadCompleted事件处理器基本的签名如下:

voidwc_OpenReadCompleted(objectsender,OpenReadCompletedEventArgse){
...
}

这个处理器中最相关的API是OpenReadCompletedEventArgs参数的Result属性,这个属性是Stream类型的,可以直接使用这个属性,或者调用需要Stream对象的方法,也可以使用StreamReader对象或者其他访问流的API。

下面就是一个下载图片的例子,本例子通过输入文件路径,然后以进度条显示下载的状态,下载完毕后进行显示。
需要注意的是:给OpenReadAsync和DownloadStringAsync API制定的URI通常采用相对路径,WebClient不支持FILE协议下载,在进行测试的时候需要注意,必须建立站点进行测试。可以使用HTTPS协议,但包含这个插件的HTML也必须同时是HTTPS协议才可以。在URI中不能使用反斜杠(\),必须使用正斜杠(/)。

例子代码如下:

Page.xaml:

<UserControlx:Class="SilverlightApplication3.Page"
xmlns
="http://schemas.microsoft.com/client/2007"
xmlns:x
="http://schemas.microsoft.com/winfx/2006/xaml"
Width
="1024"Height="800">
<Gridx:Name="LayoutRoot"Background="White">
<CanvasCanvas.Top="0">
<RectangleName="progressRectangle"Canvas.Left="20"Canvas.Top="10"Height="10"Width="0"Fill="Navy"/>
<RectangleCanvas.Top="9"Canvas.Left="19"Height="12"Width="202"StrokeThickness="1"Stroke="Black"/>
<TextBlockx:Name="progressText"Canvas.Top="6"Canvas.Left="230"Text="0%"FontSize="12"/>
<TextBoxx:Name="filepath"Canvas.Left="20"Width="100"Canvas.Top="26"Text="p1.jpg"></TextBox>
<ButtonCanvas.Top="26"Canvas.Left="130"Content="下载文件"Click="Button_Click"></Button>
<ImageCanvas.Left="60"x:Name="img"Canvas.Top="60"Width="1024"></Image>
</Canvas>
</Grid>
</UserControl>

Page.xaml.cs:

usingSystem;
usingSystem.Collections.Generic;
usingSystem.Linq;
usingSystem.Windows;
usingSystem.Windows.Controls;
usingSystem.Windows.Documents;
usingSystem.Windows.Input;
usingSystem.Windows.Media;
usingSystem.Windows.Media.Imaging;
usingSystem.Windows.Shapes;
usingSystem.Net;
usingSystem.IO;
usingSystem.Windows.Resources;

namespaceSilverlightApplication3
{
publicpartialclassPage:UserControl
{
publicPage()
{
InitializeComponent();
}
privatevoidButton_Click(objectsender,RoutedEventArgse)
{
img.Source
=null;
WebClientwc
=newWebClient();
if(wc.IsBusy)
{
wc.CancelAsync();
}
wc.OpenReadCompleted
+=newOpenReadCompletedEventHandler(wc_OpenReadCompleted);
wc.DownloadProgressChanged
+=newDownloadProgressChangedEventHandler(wc_DownloadProgressChanged);
wc.OpenReadAsync(
newUri(filepath.Text,UriKind.Relative));

}

voidwc_OpenReadCompleted(objectsender,OpenReadCompletedEventArgse)
{
BitmapImageimgsrc
=newBitmapImage();
imgsrc.SetSource(e.Result
asStream);
img.Source
=imgsrc;
}

voidwc_DownloadProgressChanged(objectsender,DownloadProgressChangedEventArgse)
{
progressText.Text
=e.ProgressPercentage.ToString()+"%";
progressRectangle.Width
=(double)e.ProgressPercentage*2;
}
}
}

运行过程中的界面和最终运行结果如下:

Silverlight 2学习教程(七):在Silverlight 2.0中制作资源加载进度条

Silverlight 2学习教程(七):在Silverlight 2.0中制作资源加载进度条