Элемент File

Статья
04/08/2023

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

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

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

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

Атрибуты

Атрибут	Описание
DocumentTemplateForList	Необязательный текст.
DoGUIDFixUp	Необязательный логический.
IgnoreIfAlreadyExists	Необязательный логический.
Level	Необязательный текст.
Имя	Необязательный атрибут типа Text. Указывает виртуальный путь файла. Не может содержать следующие символы: " # % & * : < > ? \ { }	~ \x7f
NavBarHome	Необязательный логический. Значение TRUE используется, если файл является конечным URL-адресом для ссылки Home в верхней панели навигации, используемой на сайте.
Путь	Необязательный текст. Указывает физический путь к файлу относительно %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. Например, при изменении домашней страницы через интерфейс пользователя в базе данных сохраняются только различия между исходным определением страницы и новой страницей. Файл default.aspx кэшируется в памяти в дополнение к файлам схем. Отображаемая в браузере страница HTML создается с использованием объединенного определения страницы, полученного из исходного определения страницы, которое кэшировано в памяти, и изменений, сохраненных в базе данных.
Url	Обязательный атрибут типа Text. Указывает виртуальный путь для файла. Если указан атрибут Name, для виртуального пути используется его значение. Если Path не указан, для физического пути используется значение атрибута Url. Не может содержать следующие символы: " # % & * : < > ? \ { }	~ \x7f

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

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

Module

Occurrences

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

Замечания

Пример использования элемента File см. в разделе Элемент Module (Site).

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