如何创建新 Silverlight 项目
Silverlight 项目文件是您可以使用不同工具来创建和编辑的文本文件。例如,可以使用 Visual Studio 2010 以及 Expression Blend 来创建 Silverlight 项目或修改现有项目。有关更多信息,请参见 Expression Blend 文档。
本主题介绍如何使用 Visual Studio 2010 来创建和生成新的 Silverlight 应用程序项目或 Silverlight 类库项目,还介绍如何向项目添加 Silverlight 库程序集。您需要以下组件来执行这些步骤:
-
Silverlight 版本 4.
-
用于 Visual Studio 2010 的 Silverlight 4 Tools.
-
Visual Studio 2010.
本主题包含以下各节:
通过使用"Silverlight 应用程序"项目模板来创建 Silverlight 应用程序项目。使用以下步骤创建新的 Silverlight 应用程序项目。
创建新的 Silverlight 应用程序项目
-
启动 Visual Studio 2010。
-
在"文件"菜单上单击"新建",再单击"项目"。
将显示"新建项目"对话框。
-
在“已安装的模板”窗格中,展开“Visual C#”或“Visual Basic”节点,然后选择“Silverlight”。
-
在模板列表中,选择“Silverlight 应用程序”。下图显示 Silverlight 项目模板的一个示例。
-
为该应用程序指定名称和位置,然后单击"确定"。
将显示“新建 Silverlight 应用程序”对话框,如下图所示。
-
选择用于承载 Silverlight 应用程序的方法。
-
如果您不想使用网站来承载 Silverlight 应用程序,请取消选中"在新网站中承载 Silverlight 应用程序"复选框。而后,将会生成 HTML 测试页以承载应用程序。
-
如果您想要在解决方案中添加一个单独的 ASP.NET 网站或 ASP.NET Web 应用程序项目,以承载 Silverlight 应用程序,请选中"在新网站中承载 Silverlight 应用程序"复选框。如果选择此选项,还必须指定"新的 Web 项目名称"和"新的 Web 项目类型"。
-
-
从“Silverlight 版本”下拉列表中,选择所需的 Silverlight 版本。
-
单击"确定"按钮。
-
若要生成 Silverlight 应用程序项目,请在"生成"菜单中单击"生成解决方案"。
-
若要调试 Silverlight 应用程序项目,请在"调试"菜单中单击"启动调试"。
-
若要运行 Silverlight 应用程序项目,请在"调试"菜单中单击"开始执行(不调试)"。
Silverlight 应用程序项目文件
Silverlight 应用程序项目包含以下配置、程序集引用和代码文件:
-
AppManifest.xml
这是生成应用程序包所需的应用程序清单文件。不要编辑此文件。
-
AssemblyInfo.cs 或 AssemblyInfo.vb
此文件包含嵌入到所生成的程序集中的名称和版本元数据。
-
.xap 文件
这是 Silverlight 应用程序包。生成 Silverlight 应用程序项目时生成此文件。应用程序包是一个压缩的 zip 文件,它具有 .xap 文件扩展名并包含启动您的应用程序所需的所有文件。有关 Silverlight 应用程序包的更多信息,请参见应用程序结构。
-
Silverlight 应用程序项目包含对以下程序集的引用:
-
mscorlib.dll
-
System.dll
-
System.Core.dll
-
System.Net.dll
-
System.Windows.dll
-
System.Windows.Browser.dll
-
System.Xml.dll
-
-
MainPage 文件
可以使用 MainPage 类来创建 Silverlight 应用程序的用户界面。MainPage 类派生自 UserControl。可以通过使用 MainPage.xaml(对于 XAML 标记)和 MainPage.xaml.cs 或 MainPage.xaml.vb(对于代码隐藏)来实现 MainPage 类。
-
App 文件
Silverlight 应用程序需要使用 App 类来显示应用程序用户界面。通过使用 App.xaml 和 App.xaml.cs 或 App.xaml.vb 来实现 App 类。在创建应用程序包(.xap 文件)后,由 Silverlight 插件将 App 类实例化。
-
测试页
如果您在"新建 Silverlight 应用程序"对话框中未选中"在新网站中承载 Silverlight 应用程序"复选框,则生成一个 HTML 页 (TestPage.html) 来承载您的应用程序。
Silverlight 应用程序项目网站文件
如果在"新建 Silverlight 应用程序"对话框中选中"在新网站中承载 Silverlight 应用程序"复选框,将创建一个 ASP.NET 网站并将其添加到 Silverlight 解决方案。该网站包含以下文件:
-
Silverlight.js
一个 JavaScript 帮助器文件,其中包含用于初始化 Silverlight 插件实例的函数和用于确定客户端上的已安装插件版本的函数。
-
HTML 文件
用于配置和实例化 Silverlight 插件的 HTML 文件,该插件下载并运行 Silverlight 应用程序。此文件的名称由 Silverlight 应用程序项目的名称和文本"TestPage.html"连接而来。
-
.aspx 文件
作为默认启动网页的 .aspx 文件。此文件的名称由 Silverlight 应用程序项目的名称和文本"TestPage.aspx"连接而来。
-
Web.config
网站配置文件。
有关将 Silverlight 集成到您的项目的更多信息,请参见将 Silverlight 与网页集成。
通过使用"Silverlight 类库"项目模板来创建 Silverlight 类库项目。使用以下步骤创建新的 Silverlight 类库项目。
创建新的 Silverlight 类库项目
-
启动 Visual Studio 2010。
-
在"文件"菜单上单击"新建",再单击"项目"。
将显示"新建项目"对话框。
-
在“已安装的模板”窗格中,展开“Visual C#”或“Visual Basic”节点,然后选择“Silverlight”。
-
在模板列表中,选择“Silverlight 类库”。
-
为该类库指定名称和位置,然后单击"确定"。
“添加 Silverlight 类库”对话框将出现。
-
从“Silverlight 版本”下拉列表中,选择所需的 Silverlight 版本,然后单击“确定”。
Silverlight 类库项目文件
Silverlight 类库项目包含以下配置、程序集引用和代码文件:
-
AssemblyInfo.cs 或 AssemblyInfo.vb
此文件包含嵌入到所生成的程序集中的名称和版本元数据。
-
Silverlight 类库项目包含对以下程序集的引用:
-
mscorlib.dll
-
System.dll
-
System.Core.dll
-
System.Net.dll
-
System.Windows.dll
-
System.Windows.Browser.dll
-
System.Xml.dll
-
-
Class1.cs 或 Class1.vb
名为 Class1 的一个类的代码文件。
安装 用于 Visual Studio 2010 的 Silverlight 4 Tools 时,将安装 Silverlight 核心运行时程序集以及 Silverlight SDK。Silverlight SDK 包括 Silverlight 库程序集,这些程序集组织为客户端和服务器库。有关 Silverlight SDK 中的控件的列表,请参见按功能分类的控件。
以下步骤说明如何添加对 Silverlight 库程序集的引用。
添加对 Silverlight 库程序集的引用
-
在"解决方案资源浏览器"中,右键单击 Silverlight 项目,然后选择"添加引用"。
-
将显示"添加引用"对话框。
-
在".NET"选项卡中,选择要添加的引用。
-
例如,您将选择 System.Windows.Controls.Data 以使用项目中的 DataGrid 控件。
-
单击"确定"。
-
您添加的引用将显示在"引用"节点中。
说明: |
---|
若要从应用程序包中排除引用的程序集,请选择该程序集引用,然后在"属性"窗口中将"复制本地"设置为 False。如果要按需检索程序集,此方法十分有用。有关更多信息,请参见应用程序结构主题。 |
若要使用 XAML 中的程序集,必须指定 XML 命名空间映射。
添加 XML 命名空间映射
-
打开 MainPage.xaml。
-
在 <UserControl> 开始标记中,添加标记以声明命名空间。例如,您将添加以下标记以使用 DataGrid。
-
若要使用 XAML 中的元素,请为名称添加在 XML 命名空间映射中指定的名称作为前缀。例如,XAML 中的 DataGrid 元素看起来类似于下面这样:
有关默认前缀和映射的列表,请参见 Silverlight 库的前缀和映射。