转:http://msdn.microsoft.com/zh-cn/library/ms467402(v=office.12).aspx
最终用户可以自定义的 Windows SharePoint Services 页(列表视图页、列表表单页和 Web 部件页)都是包含要显示的内容的内容页。当用户请求内容页时,它将与母版页合并以生成输出,此输出将母版页的布局与内容页的内容结合在一起。
所有内容页共享相同的页结构,即全局面包屑、网站标题区域、顶部导航、页标题区域和左侧导航栏。在 Windows SharePoint Services 中,将此共享的页结构移动到名为“default.master”的母版页中,此页由所有的内容页使用,其中包括:
-
default.aspx
-
AllItems.aspx、DispForm.aspx、NewForm.aspx 和 EditForm.aspx(对于所有列表)
-
Upload.aspx 和 Webfldr.aspx(对于所有文档库)
-
在此网站中创建的任何新的内容页
在安装时,default.master 位于 <%System Drive%>Program FilesCommon FilesMicrosoft SharedWeb Server Extensions12TEMPLATEGLOBAL
。只要没有自定义该母版页,就将在前端 Web 服务器上对其页自定义进行缓存,并在网站之间共享此页自定义。如果随后为特定的 Windows SharePoint Services 网站编辑 default.master 内部的母版页定义,则稍后会将母版页文件的已编辑副本存储在内容数据库中。
内容页的标准集都使用默认的母版页,并且它们最初位于其他模板页所在的目录区域中的文件系统中。例如,在 SharePoint 工作组网站中,default.aspx 存储在
<%SystemDrive%>Program FilesCommon FilesMicrosoft SharedWeb Server Extensions12TEMPLATESiteTemplatesSTS
中,而表单页(如 editform.aspx)存储在其各自的
<%SystemDrive%>Program FilesCommon FilesMicrosoft SharedWeb Server Extensions12TEMPLATEFeatures
文件夹中。在自定义内容页之后,该页将存储在内容数据库中。
在 default.master 中定义的内容占位符
除了在所有页上显示的静态文本和控件之外,母版页还包括一个或多个 System.Web.UI.WebControls.ContentPlaceHolder 控件,此控件定义可替换内容可以出现的区域。接着在内容页中定义可替换内容。
Windows SharePoint Services 默认母版页包含几个 ContentPlaceHolder 控件,以便能够轻松自定义单个内容页。默认情况下,Windows SharePoint Services 内容页使用下表中描述的内容占位符。在创建自定义母版页时,开发人员必须使用相同的内容占位符集或这些占位符的超集;否则,其页面可能将无法呈现。
下表描述 Windows SharePoint Services 默认母版页中包含的内容占位符以及每个占位符在页上所表示的内容。
内容占位符的名称 |
说明 |
PlaceHolderAdditionalPageHead |
必须位于页的 <head> 标记内的附加内容,例如,对样式表中的脚本的引用 |
PlaceHolderBodyAreaClass |
页面页眉中的附加正文样式 |
PlaceHolderBodyLeftBorder |
主页正文的边框元素 |
PlaceHolderBodyRightMargin |
主页正文的右边距 |
PlaceHolderCalendarNavigator |
当日历在页上可见时,显示用于在日历中导航的日期选取器 |
PlaceHolderFormDigest |
“格式摘要”安全控件 |
PlaceHolderGlobalNavigation |
全局导航面包屑 |
PlaceHolderHorizontalNav |
页的顶部导航菜单 |
PlaceHolderLeftActions |
左侧导航区域的底部 |
PlaceHolderLeftNavBar |
左侧导航区域 |
PlaceHolderLeftNavBarBorder |
左侧导航栏上的边框元素 |
PlaceHolderLeftNavBarDataSource |
左侧导航菜单的数据源 |
PlaceHolderLeftNavBarTop |
左侧导航区域的顶部 |
PlaceHolderMain |
页的主要内容 |
PlaceHolderMiniConsole |
一个用于显示页级别命令的位置,例如,WIKI 命令(如“编辑页”、“历史记录”和“传入链接”) |
PlaceHolderNavSpacer |
左侧导航区域的宽度 |
PlaceHolderPageDescription |
页内容的说明 |
PlaceHolderPageImage |
页的左上区域中的页图标 |
PlaceHolderPageTitle |
在浏览器的标题栏中显示的页 <Title> |
PlaceHolderSearchArea |
搜索框区域 |
PlaceHolderSiteName |
网站名称 |
PlaceHolderTitleAreaClass |
页面页眉中的附加样式 |
PlaceHolderTitleAreaSeparator |
显示标题区域的阴影 |
PlaceHolderTitleBreadcrumb |
主要内容面包屑区域 |
PlaceHolderTitleInTitleArea |
在面包屑下方立即显示的页标题 |
PlaceHolderTitleLeftBorder |
标题区域的左边框 |
PlaceHolderTitleRightMargin |
标题区域的右边距 |
PlaceHolderTopNavBar |
顶部导航区域 |
PlaceHolderUtilityContent |
必须位于页的底部的额外内容 |
SPNavigation |
默认情况下,在 Windows SharePoint Services 中为空。可用于附加页编辑控件。 |
WSSDesignConsole |
当页处于“编辑页”模式中时,此页将编辑控件(在单击“网站操作”之后,单击“编辑页”) |