[演练]如何创建新Silverlight项目

 

Silverlight 项目文件是您可以使用不同工具来创建和编辑的文本文件。例如，可以使用 Visual Studio 2008 和 Expression Blend 来创建 Silverlight 项目或修改现有项目。有关更多信息，请参见 Expression Blend 文档。

本主题介绍如何使用 Visual Studio 2008 来创建和生成新的 Silverlight 应用程序项目或 Silverlight 类库项目，还介绍如何向项目添加 Silverlight 库程序集。您需要以下组件来执行这些步骤：

• Silverlight 版本 3.

• Silverlight Tools for Visual Studio 2008.

• Visual Studio 2008 SP1。

本主题包括下列各节。

• Silverlight 应用程序项目
• Silverlight 类库项目
• 添加 Silverlight 库程序集
• 相关主题

  Silverlight 应用程序项目

通过使用"Silverlight 应用程序"项目模板来创建 Silverlight 应用程序项目。使用以下步骤创建新的 Silverlight 应用程序项目。

创建新的 Silverlight 应用程序项目

1. 启动 Visual Studio 2008。

2. 在"文件"菜单上单击"新建"，再单击"项目"。

   将显示"新建项目"对话框。

3. 在"项目类型"窗格中，展开"Visual C#"或"Visual Basic"节点，然后选择"Silverlight"。

4. 在"模板"窗格中，选择"Silverlight 应用程序"。

5. 为该应用程序指定名称和位置，然后单击"确定"。

   "新建 Silverlight 应用程序"对话框将出现。

6. 选择承载 Silverlight 应用程序的方法

   1. 如果您想要在解决方案中添加一个单独的 ASP.NET 网站或 ASP.NET Web 应用程序项目，以承载 Silverlight 应用程序，请选中"在新网站中承载 Silverlight 应用程序"复选框。如果选择此选项，还必须指定"新的 Web 项目名称"和"新的 Web 项目类型"。

   2. 如果您不想使用网站来承载 Silverlight 应用程序，请取消选中"在新网站中承载 Silverlight 应用程序"复选框。而后，将会生成 HTML 测试页以承载应用程序。

7. 单击"确定"按钮。

8. 若要生成 Silverlight 应用程序项目，请在"生成"菜单中单击"生成解决方案"。

9. 若要调试 Silverlight 应用程序项目，请在"调试"菜单中单击"启动调试"。

10. 若要运行 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 解决方案。该网站包含以下文件：

• 默认文件

  一个默认网页，它包含标记文件 Default.aspx 和代码隐藏文件 Default.aspx.cs 或 Default.aspx.vb。

• Web.config

  网站配置文件。

• HTML 文件

  用于配置和实例化 Silverlight 插件的 HTML 文件，该插件下载并运行 Silverlight 应用程序。此文件的名称由 Silverlight 应用程序项目的名称和文本"TestPage.html"连接而来。

• .aspx 文件

  作为默认启动网页的 .aspx 文件。此文件的名称由 Silverlight 应用程序项目的名称和文本"TestPage.aspx"连接而来。

有关将 Silverlight 集成到您的项目的更多信息，请参见将 Silverlight 与网页集成。

  Silverlight 类库项目

通过使用"Silverlight 类库"项目模板来创建 Silverlight 类库项目。使用以下步骤创建新的 Silverlight 类库项目。

创建新的 Silverlight 类库项目

1. 启动 Visual Studio 2008。

2. 在"文件"菜单上单击"新建"，再单击"项目"。

   将显示"新建项目"对话框。

3. 在"项目类型"窗格中，展开"Visual C#"或"Visual Basic"节点，然后选择"Silverlight"。

4. 在"模板"窗格中，选择"Silverlight 类库"。

5. 为该类库指定名称和位置，然后单击"确定"。

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 的一个类的代码文件。

  添加 Silverlight 库程序集

安装 Silverlight Tools for Visual Studio 2008 时，将安装 Silverlight 核心运行时程序集以及 Silverlight SDK。Silverlight SDK 包括 Silverlight 库程序集，这些程序集组织为客户端和服务器库。 有关 Silverlight SDK 中的控件的列表，请参见按功能分类的控件。

以下步骤说明如何添加对 Silverlight 库程序集的引用。

添加对 Silverlight 库程序集的引用

1. 在"解决方案资源管理器"中，右键单击 Silverlight 项目，然后选择"添加引用"。

2. 将显示"添加引用"对话框。

3. 在".NET"选项卡中，选择要添加的引用。

4. 例如，您将选择 System.Windows.Controls.Data 以使用项目中的 DataGrid 控件。

5. 单击"确定"。

6. 您添加的引用将显示在"引用"节点中。

说明：

若要从应用程序包中排除引用的程序集，请选择该程序集引用，然后在"属性"窗口中将"复制本地"设置为 False。如果要按需检索程序集，此方法十分有用。有关更多信息，请参见应用程序结构主题。

若要使用 XAML 中的程序集，必须指定 XML 命名空间映射。

添加 XML 命名空间映射

1. 打开 MainPage.xaml。

2. 在 开始标记中，添加标记以引用命名空间和程序集。例如，您将添加以下标记以使用 DataGrid。

   复制代码

   xmlns:data="clr-namespace:System.Windows.Controls;assembly=System.Windows.Controls.Data"

3. 若要使用 XAML 中的元素，请为名称添加在 XML 命名空间映射中指定的名称作为前缀。例如，XAML 中的 DataGrid 元素看起来类似于下面这样：

   复制代码

   有关默认前缀和映射的列表，请参见 Silverlight 库的前缀和映射。

  请参见

其他资源

Silverlight 入门

演练：创建您的第一个 Silverlight 应用程序