Поделиться через


Элемент File (Module)

Область применения: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Указывает файл, который будет включен в модуль в определении сайта.

Определение

<File
  DocumentTemplateForList = string
  DoGUIDFixUp = "TRUE" | "FALSE"
  IgnoreIfAlreadyExists = "TRUE" | "FALSE"
  Level = Draft
  Name = string
  NavBarHome = "TRUE" | "FALSE"
  Path = string  ReplaceContent = "TRUE" | "FALSE"
  Type = "Ghostable" | "GhostableInLibrary"
  Url = string>
  <AllUsersWebPart />
  <BinarySerializedWebPart />
  <NavBarPage />
  <Property />
  <View />
  <WebPartConnection />
</File>

Элементы и атрибуты

В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.

Атрибуты

Атрибут

Описание

**IgnoreIfAlreadyExists**

Необязательный параметр **Boolean**. **TRUE** для подготовки представления, даже если файл уже существует по указанному URL-адресу; В противном случае — **FALSE**.

**Имя**

Необязательный параметр **Text**. Указывает виртуальный путь файла. Не может содержать следующие символы:

  • `"`

  • `#`

  • `%`

  • `&`

  • `*`

  • `:`

  • `<`

  • `>`

  • `?`

  • `\`

  • `{`

  • `}`

  • `|`

  • `~`

  • '\x7f'

**NavBarHome**

Необязательный параметр **Boolean**. **TRUE***, если файл является URL-адресом назначения для ссылки **Home** в верхней панели навигации, используемой на всем сайте.

**Путь**

Необязательный параметр **Text**. Указывает физический путь к файлу относительно %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\Features\Feature. Может содержать только следующие символы:

  • Буквы

  • дефис ('-')

  • Подчеркнуть ('_')

  • точка ('.')

  • пробел ( ).

**Тип**

Необязательный параметр **Text**. Указывает возможность кэширования файла в памяти на интерфейсном веб-сервере. Возможные значения: **Ghostable** и **GhostableInLibrary**. Оба значения указывают, что файл будет кэширован, но **GhostableInLibrary** указывает, что файл кэшируется как часть списка, базовый тип которого — **DocumentLibrary**.

При изменении, например, домашней страницы с помощью пользовательского интерфейса, в базе данных сохраняются только отличия от исходного определения страницы, тогда как файл default.aspx кэшируется в память вместе с файлами схемы. Страница HTML, отображаемая в браузере, создается с помощью комбинированного определения, являющегося результатом кэшированного в память исходного определения и хранящихся в базе данных изменений.

**ReplaceContent**

Необязательный параметр **Boolean**. **TRUE** для перезаписи ранее установленной версии файла новой версией при применении манифеста элемента при обновлении родительского компонента; В противном случае **FALSE**.

**Url**

Обязательный **Текст**. Указывает виртуальный путь для файла. Если указан атрибут **Name**, его значение используется для виртуального пути. Если **Путь** не указан, для физического пути используется значение **Url**. Не может содержать следующие символы:

  • `"`

  • `#`

  • `%`

  • `&`

  • `*`

  • `:`

  • `<`

  • `>`

  • `?`

  • `\`

  • `{`

  • `}`

  • `|`

  • `~`

  • '\x7f'

Дочерние элементы

AllUsersWebPart, элемент BinarySerializedWebPart (Module),NavBarPage, Property, View, Элемент WebPartConnection (Module)

Родительские элементы

Module

Occurrences

Минимум: 0

Максимум: без ограничений

Пример

Пример использования этого элемента см. в разделе Modules.

См. также