File 元素（网站）

  • 项目

上次修改时间： 2015年3月9日

适用范围： SharePoint Foundation 2010

本文内容
属性
子元素
父元素
出现次数

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

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

属性

属性

说明

DocumentTemplateForList

可选属性，类型为 Text。

DoGUIDFixUp

可选属性，类型为 Boolean。

IgnoreIfAlreadyExists

可选属性，类型为 Boolean。

Level

可选属性，类型为 Text。

Name

可选属性，类型为 Text。指定文件的虚拟路径。路径中不能包含下列字符：

  • \"

  • #

  • %

  • &

  • *

  • :

  • <

  • >

  • ?

  • \\

  • {

  • }

  • |

  • ~

  • \x7f

NavBarHome

可选属性，类型为 Boolean。如果文件是用于整个网站的顶部导航栏中 Home 链接的目标 URL，则为 TRUE。

Path

可选属性，类型为 Text。指定文件相对于 Onet.xml 文件的 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\SiteTemplates\网站定义 的物理路径。指定文件相对于 Feature.xml 文件的%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES\功能名称 的物理路径。只能包含下列字符：

  • 字母数字

  • 连字符 (-)

  • 下划线字符 (_)

  • 句号 (.)

  • 空格 ( )

Type

可选属性，类型为 Text。指定在前端服务器内存中缓存文件。可能的值包括 Ghostable 和 GhostableInLibrary。这两个值均指定要缓存的文件，但 GhostableInLibrary 指定将文件作为其基本类型为 DocumentLibrary 的列表的一部分进行缓存。

例如，当通过用户界面 (UI) 对主页进行更改时，只会将原始页定义与新页面之间的差异存储到数据库中。除缓存架构文件外，还会在内存中缓存 default.aspx。浏览器中显示的 HTML 页是通过组合页定义构建的，该组合页定义来源于内存中缓存的原始页定义和数据库中存储的更改。

Url

必需属性，类型为 Text。指定文件的虚拟路径。如果指定了 Name 属性，则其值将用于该虚拟路径。如果未指定 Path，则 Url 的值将用于物理路径。路径中不能包含下列字符：

  • \"

  • #

  • %

  • &

  • *

  • :

  • <

  • >

  • ?

  • \\

  • {

  • }

  • |

  • ~

  • \x7f

子元素

AllUsersWebPart、BinarySerializedWebPart、NavBarPage、Property、View、WebPartConnection

父元素

Module

出现次数

最小值：0

最大值：无限制

备注

有关使用 File 元素的示例，请参阅 Module 元素（网站）。