寒夜听雨【程序开发专栏】

C#、ASP.NET、SQL SERVER、PowerBuilder技术交流
  博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

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;
        }
    }
}

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


文章来源:http://dotnet.aspx.cc/article/43a83bc8-48e1-4d7f-9479-ab231af61dfd/read.aspx