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事件处理器基本的签名如下：

void wc_OpenReadCompleted(object sender, OpenReadCompletedEventArgs e) {
...
}

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

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

例子代码如下：

Page.xaml：

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

Page.xaml.cs：

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

namespace SilverlightApplication3
{
    public partial class Page : UserControl
    {
        public Page()
        {
            InitializeComponent();
        }
        private void Button_Click(object sender, RoutedEventArgs e)
        {
          img.Source = null;
            WebClient wc = new WebClient();
            if (wc.IsBusy)
            {
                wc.CancelAsync();
            }
            wc.OpenReadCompleted += new OpenReadCompletedEventHandler(wc_OpenReadCompleted);
            wc.DownloadProgressChanged += new DownloadProgressChangedEventHandler(wc_DownloadProgressChanged);
            wc.OpenReadAsync(new Uri(filepath.Text, UriKind.Relative));

        }

        void wc_OpenReadCompleted(object sender, OpenReadCompletedEventArgs e)
        {
            BitmapImage imgsrc = new BitmapImage();
            imgsrc.SetSource(e.Result as Stream);
            img.Source = imgsrc;
        }

        void wc_DownloadProgressChanged(object sender, DownloadProgressChangedEventArgs e)
        {
            progressText.Text = e.ProgressPercentage.ToString() + "%";
            progressRectangle.Width = (double)e.ProgressPercentage * 2;
        }
    }
}