应用程序页是一个 ASP.NET 网页,旨在用于 SharePoint 网站。 应用程序页是一种专用类型的 ASP.NET 页。 应用程序页与标准 ASP.NET 页面的主要区别在于,应用程序页包含与 SharePoint 母版页合并的内容。 母版页使应用程序页面能够与网站上的其他页面共享相同的外观和行为。
Visual Studio 使你能够使用设计器设计应用程序页。 设计器显示母版页中定义的每个内容占位符的内容区域。 可以通过将控件拖动到这些内容区域来设计应用程序页。
应用程序页
应用程序页面在服务器上的所有网站之间共享,而网站页面特定于一个网站。 有关详细信息, 请参阅 SharePoint 页面类型。
默认情况下,创建 SharePoint 网站时显示的大多数页面都是网站页面。 网站页面可以添加到 SharePoint 页面库。 用户可以使用 SharePoint Designer 等工具自定义网站页面。 网站页面还可以托管动态 Web 部件和 Web 部件区域等功能。
应用程序页无法执行这些功能。 但是,如果希望页面包含自定义代码,应用程序页是创建的最佳页面类型。 尽管您可以将自定义代码添加到网站页面,但当用户使用 SharePoint Designer 等工具自定义页面时,代码将停止运行。
注释
Visual Studio 不提供帮助为 SharePoint 网站创建网站页面的模板。 有关详细信息,请参阅 SharePoint 页面类型。
创建应用程序页
若要创建应用程序页,请将 应用程序页 项添加到 SharePoint 项目。 创建应用程序页时,Visual Studio 会将以下文件夹添加到项目:
| 文件夹 | Description |
|---|---|
| Layouts | 映射到 SharePoint 文件系统的 _layouts 虚拟目录。 |
| 布局子文件夹 | 包含构成应用程序页的文件。 默认情况下,此文件夹的名称与项目相同。 可以随时重命名此文件夹。 运行项目时,Visual Studio 会将此文件夹部署到 SharePoint 文件系统的_layouts虚拟目录。 |
Visual Studio 将以下文件添加到项目:
| 文件 | Description |
|---|---|
| ASP.NET 页文件(.aspx) | 包含定义页面的 XML 标记。 |
| 应用程序页代码文件 | 包含应用程序页后面的代码。 添加用于处理此文件事件的代码。 |
| 应用程序页设计器代码文件 | 包含设计器生成的代码。 请勿直接编辑此文件。 |
设计和调试应用程序页
使用 Visual Studio 中的设计器视图设计应用程序页的内容。 当在项目中打开应用程序页面(双击它或打开其快捷菜单,然后选择 “打开”),然后选择编辑器底部的 “设计 ”按钮时,将显示此设计器。
注释
只能在设计器的 “源 ”视图中设计页面。 应用页面的设计视图已禁用。
可以调试应用程序页,就像在 Visual Studio 中调试其他 SharePoint 项目项一样。 启动 Visual Studio 调试器时,Visual Studio 将打开 SharePoint 网站。
若要查看应用程序页,必须手动导航到应用程序页的位置(例如:http:// Server_Name/_layouts/Project_Name/ApplicationPage1.aspx)。
有关如何调试 SharePoint 项目的详细信息,请参阅 SharePoint 解决方案疑难解答。
选择母版页
默认情况下, 应用程序页 项引用用于调试项目的网站母版页。 该页面名为 v4.master,您可以在 SharePoint 网站的 母版页库中 找到它。
可以通过设置应用程序MasterPageFile元素的Page属性,来显式更改应用程序页所使用的母版页。 (例如: MasterPageFile="~/_layouts/applicationv4.master"。 事实上,如果在 SharePoint 服务器上未启用动态母版页,则必须设置此属性。 有关 SharePoint 中的母版页的详细信息,请参阅 母版页。