如何自定义silverlight的加载页面

来源:互联网 发布:中国投资咨询 知乎 编辑:程序博客网 时间:2024/06/05 02:44
开发平台
我用的是Visual Studio 2010 + Silverlight 4
其实用Visual Studio 2010/2008 + Silverlight 4/3都可以的

下面首先介绍一下加载的原理:
其实就是建二个项目:一个较小,用于加载较大的项目文件,并在加载过程中给用户显示加载进度,假设为SLLoader.xap;另一个为我们的具体功能实现项目,不妨假设为LoadTarget.xap。
客户端下载程序时,首先加载SLLoader.xap,这个过程应该是比较快的,然后由SLLoader.xap一边加载较大的LoadTarget.xap,一边显示进度或动画,当加载LoadTarget.xap完毕后,就调用打开LoadTarget.xap,至些,我们的项目已加载完毕。

关于该加载过程的详细资料,可参考如下页面:
How the Silverlight loader works
http://www.apijunkie.com/APIJunkie/blog/page/How-the-Silverlight-loader-works.aspx
Silverlight Loader Getting Started Guide
http://www.apijunkie.com/APIJunkie/blog/page/Silverlight-Loader-Getting-Started-Guide.aspx
Silverlight Loader Class Diagram
http://silverlightloader.codeplex.com/wikipage?title=Class%20Diagram&referringTitle=Home

网上有一篇关于实现加载的介绍,基本上是翻译过来的,不是很详细,文章在此:
http://silverlightchina.net/html/tips/2010/0115/588.html

下面我根据上面的几篇文章详细介绍项目的实现过程:

第一步:创建一个SLLoader.xap项目或在现有的SLLoader.xap项目中使用Silverlight Loader

1.在现有SLLoader.xap项目中使用SilverlightLoader:先下载SilverlightLoader压缩包,从下载的Release中找到SilverlightLoader.cs,并将其添加到SLLoader.xap项目中,具体实现方法:在SLLoader.xap项目中右键添加已有项,浏览找到SilverlightLoader.cs即可添加。
2.通过项目模板创建一个SLLoader.xap项目:将SilverlightLoader模板文件拷贝到VS的模板文件夹下,如My Documents\Visual Studio 2008\ProjectTemplates\Visual C#。而后就可以在新建项目时看到Silverlight Loader项目了。

第二步:实现ISliverlightLoader接口

1.添加对SilverlightLoader的引用
在App.xaml.cs中添加对命名空间SilverlightLoader的引用,实现代码:
using SilverlightLoader;
在MainPage.xaml.cs中添加对命名空间SilverlightLoader的引用,实现代码:
using SilverlightLoader;

2.创建动态加载外部数据的开始点
在App.xaml.cs中的Application_Startup事件中开始载入数据包,代码如下:

private void Application_Startup(object sender, StartupEventArgs e)
{
    //无需该默认语句
    //this.RootVisual = new MainPage();

    //建立加载页
    MainPage loader = new MainPage();

    //设置该加载页为加载项
    this.RootVisual = loader;

    //建立加载数据包管理类,并开始加载目标xap,
    //该类的构造函数中的第三个参数为模拟加载网速,
    //为了模拟加载过程和调试,可以通过设置该参数来模拟加载速度,单位为Kb,
    //当设该参数为0时,则采用真实带宽加载目标xap。
    PackageDownloadManager pdm = new PackageDownloadManager(loader, e.InitParams, 0);
}

3.在MainPage.xaml.cs中实现ISliverlightLoader接口
有如下几个ISilverlightLoader接口需要添加,也就是在下面几接口中实现加载进度的交互显示:
// 初始化加载须加载的数据包列表
void initCallback(List<Uri> packageSourceList);       
// 回调函数,用于标识开始加载数据包
void downloadStartCallback(Uri packageSource);
// 回调函数,用于标识加载进度发生变化
void downloadProgressCallback(Uri packageSource, DownloadProgressEventArgs eventArgs);
// 回调函数,用于标识加载数据包结束
void downloadCompleteCallback(Uri packageSource, DownloadCompleteEventArgs eventArgs);

MainPage.xaml.cs中的实现代码如下,我现在把MainPage.xaml.cs的代码全部粘上,红色部分为所添加代码:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Windows;
using System.Windows.Controls;
using System.Windows.Documents;
using System.Windows.Input;
using System.Windows.Media;
using System.Windows.Media.Animation;
using System.Windows.Shapes;
using SilverlightLoader;

namespace SLLoader
{
    //注意此处的类继承:SilverlightLoader.ISilverlightLoader
    public partial class MainPage : UserControl, SilverlightLoader.ISilverlightLoader
    {
        public MainPage()
        {
            InitializeComponent();
        }

        #region ISilverlightLoader Members

        //初始化加载须加载的数据包列表
        void ISilverlightLoader.initCallback(System.Collections.Generic.List<Uri> packageSourceList)
        {

        }

        //回调函数,用于标识开始加载数据包
        void ISilverlightLoader.downloadStartCallback(Uri packageSource)
        {
            LoadProgress.Text = "加载初始化...";
        }

        //回调函数,用于标识加载进度发生变化
        void ISilverlightLoader.downloadProgressCallback(Uri packageSource, DownloadProgressEventArgs eventArgs)
        {
            float offset = ((float)eventArgs.ProgressPercentage * 4 / 100f) * 1000;
            TimeSpan ts = new TimeSpan(0, 0, 0, 0, (int)offset);
           
            //显示加载进度,例如下面二行代码中LoadProgress为一个Textblock,LoadProgressBar为一个进度条,则可以使用下面语句显示进度
            LoadProgress.Text = eventArgs.ProgressPercentage.ToString() + "%";
            LoadProgressBar.Value = eventArgs.ProgressPercentage;
        }

        //回调函数,用于标识加载数据包结束
        void ISilverlightLoader.downloadCompleteCallback(Uri packageSource, DownloadCompleteEventArgs eventArgs)
        {
            LoadProgress.Text = "加载完成";
            XapUtil.setCurrentXapFile(packageSource);
        }

        #endregion
    }
}

第三步:在HTML页面或asp:Silverlight控件设置初始载入界面与载入目标
该步就是在HTML或asp:Silverlight控件中加入对SLLoader.xap的调用,并将LoadTarget.xap的名字做为参数传递给SLLoader.xap,以便加载,
可以看出,在建立整个项目的过程中,SLLoader.xap和LoadTarget.xap并不需要打交道,只在HHTML或asp:Silverlight控件设置中才把二者联系起来。

1.HTML中的设置方法:
<object data="data:application/x-silverlight-2," type="application/x-silverlight-2"
    width="550" height="400">
    <param name="source" value="SLLoader.xap" />
    <param name="onerror" value="onSilverlightError" />
    <param name="background" value="white" />
    <param name="minRuntimeVersion" value="2.0.31005.0" />
    <param name="autoUpgrade" value="true" />
    <param name="initParams" value="LoaderSourceList=LoadTarget.xap" />
    <a href="http://go.microsoft.com/fwlink/?LinkID=124807" style="text-decoration: none;">
        <img src="http://go.microsoft.com/fwlink/?LinkId=108181" alt="Get Microsoft Silverlight"
        style="border-style: none" />
    </a>
< /object>
注意SLLoader.xap和LoadTarget.xap的位置,此时把HTML文件、SLLoader.xap和LoadTarget.xap放在同一目录下即可实现加载。

2.在asp:Silverlight控件中设置的方法
<asp:Silverlight ID="Xaml1" runat="server" Source="~/SLLoader.xap" MinimumVersion="2.0.31005.0"
    Width="550" Height="400" InitParameters="LoaderSourceList=LoadTarget.xap" />
与在HTML中通过Object对象设置的原理相同。

3.如果此时编译SLLoader.xap项目,可能通不过,提示缺少对System.Runtime.Serialization.Json的引用,
为解决此问题,需要添加如下三个引用,参考文章:http://www.cnblogs.com/Blackie/archive/2009/07/09/1520080.html
1.System.Runtime.Serialization
2.System.ServiceModel
3.System.ServiceModel.Web

至此,一个加载功能制作完毕。

注意事项:
(1)App和MailPage都需要添加对命名空间SilverlightLoader的引用;
(2)PackageDownloadManager类构造函数中的第三个参数需要更改,看前面的代码注释,在此处将参数改为一个较小的值,即可减小加载速度,以便查看加载效果;
(3)需要添加以下三个引用,只有同时添加,才能正确引用System.Runtime.Serialization.Json:
1.System.Runtime.Serialization
2.System.ServiceModel
3.System.ServiceModel.Web

目前已知的问题:
实现该加载功能的目的就是不想显示Silverlight默认的那个蓝色整圆圆的加载动画,
但如果网速过慢,还是会显示加载SLLoader.xap的动画,另外SLLoader.xap加载完LoadTarget.xap后,打开LoadTarget.xap的过程中也可能会出现默认的那个加载动画,虽然只是一瞬间,不知道该怎么屏蔽这个默认的动画,请大家支招