/AssemblyNavigation

A navigation framework for Silverlight, witch can load your silverlight assembly on demand.

Primary LanguageC#

Sliverlight 导航框架

特点

按需加载 Silverlight 组件

与 SL 内置实现了真正意义的按需加载, 主程序可以非常小, 最小不超过 200 KB, 只有当点击链接之后, 才会去服务端下载 对应的组件, 每个组件文件只会下载一次。 如果要下载的组件引用了其它第三方的组件, 也会自动下载第三方组件, 下载第这些 时会自动过滤掉重复的组件。

几乎零配置

使用这个导航框架几乎不需要在客户端或服务端做任何配置, 整个加载过程是自动完成的, 你需要写的只是导航的菜单项。

使用方法

主程序

  1. 添加对 AssemblyNavigation、 System.Windows.Controls.Navigation 的引用至项目;

  2. 在主页面的 xaml 代码添加下面的 xmlns 引用:

     xmlns:sdk="http://schemas.microsoft.com/winfx/2006/xaml/presentation/sdk"  
     xmlns:asmNav="clr-namespace:Beginor.AssemblyNavigation;assembly=Beginor.AssemblyNavigation"
     
  3. 添加 Frame 控件并设置 ContentLoader, 代码如下:

     <sdk:Frame Name="MainFrame" Grid.Row="1" Source="MainApp.WelcomePage,MainApp">
        <sdk:Frame.ContentLoader>
           <asmNav:AssemblyNavigationContentLoader />
        </sdk:Frame.ContentLoader>
     </sdk:Frame>
     

模块

每个模块需要添加对 System.Windows.Controls.Navigation 的引用, 至少要有一个页面(否则就不是模块了), 这个 页面需要继承自 System.Windows.Controls.Page 类。

导航链接地址格式

导航地址的链接地址格式为要显示的模块的完整的类型名称, 例如:

<StackPanel Orientation="Horizontal">
<HyperlinkButton Content="Welcome Page" NavigateUri="MainApp.WelcomePage,MainApp"/>
<HyperlinkButton Content="Chart Page" NavigateUri="ChartModule.ChartPage,ChartModule"/>
<HyperlinkButton Content="Map Page" NavigateUri="MapModule.MapPage,MapModule"/>
<HyperlinkButton Content="Grid Page" NavigateUri="GridModule.GridPage,GridModule"/>
</StackPanel>

如果这份文档还不够清楚, 可以从 GitHub 网站项目下载这个项目, 有一个完整的测试程序。

注意问题

  • 如果模块引用的第三方组件只在 xaml 中使用, 则必须添加 x:Name 属性, 否则可能会出现找不到这个第三方 组件的问题;
  • 如果模块的 xaml 中引用了 clrnamespace , 则必须指定 assembly 值, 否则也可能会出现问题。