Site) (模块元素

适用于: SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

指定要预配网站的文件和“所有用户”Web 部件。

<Module>
  HyperlinkBaseUrl = "Text"
  IncludeFolders = "Text"
  List = "Integer"
  Name = "Text"
  Path = "Text"
  RootWebOnly = "TRUE" | "FALSE"
  SetupPath = "Text"
  Url = "Text"
</Module>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

属性 说明
HyperlinkBaseUrl
可选 文本
IncludeFolders
可选 文本
列表
可选属性,类型为 Integer。 指定在 Onet.xml 内定义的列表的类型。
名称
必需属性,类型为 Text。 包含文件集的名称。

只能包含下列字符:
字母
连字符 (-)
下划线字符 (_)
period (.)
空格 ( )
路径
可选 文本。 指定相对于 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\SiteTemplates\ _Site_Definition_ 的文件集的物理路径。

只能包含下列字符:
字母
连字符 (-)
下划线 (_)
period (.)
空格 ( )
RootWebOnly
可选属性,类型为 Boolean如果 模块中指定的文件仅安装在网站集的顶级网站中,则为 TRUE。
SetupPath
可选 文本。 指定 SharePoint Foundation 安装目录 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE) 中包含要包含在模块中的文件的物理路径。

只能包含下列字符:
字母
连字符 (-)
下划线 (_)
period (.)
空格 ( )
Url
可选属性,类型为 Text。指定实例化网站时要在其中放置文件的文件夹的虚拟路径。如果未指定 Path,则 Url 的值将用于物理路径。使用 Url 属性可通过网站定义设置文件夹。

Url 属性不能包含下列字符:
"
#
%
&
*
:
<
>
?
\
{
}
|
~
\x7f

子元素

父元素

出现次数

  • 最小值:0
  • 最大值:无限制

备注

一个详细的 Module 元素显示在文件的 Project 元素下的 Modules 元素中Onet.xml。 每个此类模块由同一文件的 Configuration 元素中的至少一个其他 Module 元素引用。

Module 元素可指定文件或文件集以及创建网站过程中这些文件的安装位置。 如果该文件是 Web 部件页,则模块定义可以指定应在页面上包含哪些 Web 部件。

示例

Onet.xml 中的以下示例定义要包含到模块中的视图和文件。

<Module Name="Default" Url="" Path="">
  <File Url="default.aspx" NavBarHome="True">
    <View List="$Resources:core,lists_Folder;/$Resources:core,announce_Folder;" BaseViewID="0" WebPartZoneID="Left" />
    <View List="$Resources:core,lists_Folder;/$Resources:core,calendar_Folder;" BaseViewID="0" RecurrenceRowset="TRUE" WebPartZoneID="Left" WebPartOrder="2" />
    <AllUsersWebPart WebPartZoneID="Right" WebPartOrder="1"><![CDATA[
      <WebPart xmlns="http://schemas.microsoft.com/WebPart/v2" xmlns:iwp="http://schemas.microsoft.com/WebPart/v2/Image">
        <Assembly>Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c</Assembly>
        <TypeName>Microsoft.SharePoint.WebPartPages.ImageWebPart
        </TypeName>
        <FrameType>None</FrameType>
        <Title>$Resources:wp_SiteImage;</Title>
                        <iwp:ImageLink>/_layouts/images/homepage.gif</iwp:ImageLink>
      </WebPart>
    ]]></AllUsersWebPart>
    <View List="$Resources:core,lists_Folder;/$Resources:core,links_Folder;" BaseViewID="0" WebPartZoneID="Right" WebPartOrder="2" />
    <NavBarPage Name="$Resources:core,nav_Home;" ID="1002" Position="Start" />
    <NavBarPage Name="$Resources:core,nav_Home;" ID="0" Position="Start" />
  </File>
</Module>

另请参阅