文件元素

适用于： Lync 2013 |Lync Server 2013 |SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

指定要包括在网站定义配置或 Web 模板配置中的模块内的文件。

<File
  DocumentTemplateForList = "Text"  DoGUIDFixUp = "TRUE" | "FALSE"
  IgnoreIfAlreadyExists = "TRUE" | "FALSE"
  Level = "Text"
  Name = "Text"
  NavBarHome = "TRUE" | "FALSE"
  Path = "Text"
  Type = "Text"
  Url = "Text >
</File>

元素和属性

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

Attributes

属性	说明
DocumentTemplateForList	可选 文本。
DoGUIDFixUp	可选属性，类型为 Boolean。
IgnoreIfAlreadyExists	可选属性，类型为 Boolean。
Level	可选 文本。
名称	可选属性，类型为 Text。 指定文件的虚拟路径。 路径中不能包含下列字符： " # % & * : < > ? \ { }	~ \x7f
NavBarHome	可选属性，类型为 Boolean。 如果文件是用于整个网站的顶部导航栏中 Home 链接的目标 URL，则为 TRUE。
路径	可选 文本。 指定相对于 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\SiteTemplates\ Site_Definition Onet.xml 文件的物理路径。 指定相对于 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\FEATURES\ Feature_Name Feature.xml 文件的物理路径。 只能包含下列字符： 字母 连字符 (-) 下划线 (_) 句点 (.) 空格 ( )
类型	可选属性，类型为 Text。 指定在前端服务器内存中缓存文件。 可能的值包括 Ghostable 和 GhostableInLibrary。 这两个值均指定要缓存的文件，但 GhostableInLibrary 指定将文件作为其基本类型为 DocumentLibrary 的列表的一部分进行缓存。 例如，当通过用户界面 (UI) 对主页进行更改时，只会将原始页定义与新页面之间的差异存储到数据库中。 除缓存架构文件外，还会在内存中缓存 default.aspx。 浏览器中显示的 HTML 页是通过组合页定义构建的，该组合页定义来源于内存中缓存的原始页定义和数据库中存储的更改。
Url	必需属性，类型为 Text。 指定文件的虚拟路径。 如果指定了 Name 属性，则其值将用于该虚拟路径。 如果未指定 Path，则 Url 的值将用于物理路径。 路径中不能包含下列字符： " # % & * : < > ? \ { }	~ \x7f

子元素

• AllUsersWebPart
• BinarySerializedWebPart
• NavBarPage
• 属性
• View
• WebPartConnection

父元素

• Module

出现次数

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

备注

有关使用 File 元素的示例，请参阅 Module 元素 (Site) 。