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

Элемент ListTemplate (List Template)

  • Статья

Дата последнего изменения: 9 марта 2015 г.

Применимо к: SharePoint Foundation 2010

В этой статье
Атрибуты
Дочерние элементы
Родительские элементы

Задает определение списка, которое можно будет использовать при создании списков на странице Создание.

<ListTemplate
  AllowDeletion = "TRUE" | "FALSE"
  AllowEveryoneViewItems = "TRUE" | "FALSE"
  AlwaysIncludeContent = "TRUE" | "FALSE"
  BaseType = "0" | "1" | "3" |"4" | "5"
  CacheSchema = "TRUE" | "FALSE"
  Catalog = "TRUE" | "FALSE"
  Category = "Libraries" | "Communications" | "Tracking" | 
    "Custom Lists"
  Default = "TRUE" | "FALSE"
  Description = "Text"
  DisableAttachments = "TRUE" | "FALSE"
  DisallowContentTypes = "TRUE" | "FALSE"
  DisplayName = "Text"
  DocumentAsEnclosure = "TRUE" | "FALSE"
  DocumentTemplate = "Integer"
  DontSaveInTemplate = "TRUE" | "FALSE"
  EditPage = "Text"
  EnableModeration = "TRUE" | "FALSE"
  EnablePeopleSelector = "TRUE" | "FALSE"
  EnableResourceSelector = "TRUE" | "FALSE"
  FeatureId = "Text"
  FolderCreation = "TRUE" | "FALSE"
  Hidden = "TRUE" | "FALSE"
  HiddenList = "TRUE" | "FALSE"
  Image = "URL"
  MultipleTypes = "TRUE" | "FALSE"
  MustSaveRootFiles = "TRUE" | "FALSE"
  Name = "Text"
  NewPage = "Text"
  NoCrawl = "TRUE" | "FALSE"
  OnQuickLaunch = "TRUE" | "FALSE"
  Path = "Text"
  RootWebOnly = "TRUE" | "FALSE"
  SecurityBits = "Text"
  Sequence = "Integer"
  SetupPath = "Text"
  SyncType = "Text"
  Type = "Integer"
  Unique = "TRUE" | "FALSE"
  UseRootFolderForNavigation = "TRUE" | "FALSE"
  VersioningEnabled = "TRUE" | "FALSE">
</ListTemplate>

Атрибуты

Атрибут

Описание

AllowDeletion

Необязательный атрибут типа Boolean. TRUE определяет, что списки, созданные с помощью шаблона, запрещено удалять; если удалять разрешается — FALSE.

AllowEveryoneViewItems

Необязательный атрибут типа Boolean. TRUE — разрешить любому пользователю просматривать элементы в библиотеке. Атрибут AllowEveryoneViewItems используется, например, в галерее главных страниц, чтобы предоставить всем пользователям доступ к главным страницам.

AlwaysIncludeContent

Необязательный атрибут типа Boolean. Когда списки, созданные с помощью шаблона, сохраняются в пользовательском интерфейсе как шаблоны списков, контент списков можно включать в шаблоны (TRUE) или не включать (FALSE).

BaseType

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

  • 0 -- GenericList

  • 1 -- DocumentLibrary

  • 3 -- DiscussionBoard

  • 4 -- Survey

  • 5 -- Issue

CacheSchema

Необязательный атрибут типа Boolean. TRUE — разрешить кэширование схемы списка при подготовке сайта. Атрибут CacheSchema используется, например, в глобальном файле Onet.xml, чтобы разрешить кэширование пользовательских списков для текущего семейства сайтов.

Catalog

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

Category

Необязательный атрибут типа Text. Определяет категорию, к которой следует относить списки, созданные с помощью определения списков. Допустимые значения:

  • Libraries

  • Communications

  • Tracking

  • Custom Lists

Default

Необязательный атрибут типа Boolean. TRUE — указать, что новые сайты SharePoint должны включать этот список.

Description

Необязательный атрибут типа Text. Предоставляет описание определения списка.

DisableAttachments

Необязательный атрибут типа Boolean. TRUE — разрешить пользователям прикреплять файлы к элементам списков, созданных с помощью шаблона; FALSE — запретить.

DisallowContentTypes

Необязательный атрибут типа Boolean. TRUE — разрешить управление типами контента для списков, созданных с помощью шаблона; FALSE — запретить.

DisplayName

Обязательный атрибут типа Text. Определяет отображаемое имя определения списка.

DocumentAsEnclosure

Необязательный атрибут типа Boolean. Указывает, содержит ли список документы в качестве вложенных объектов.

DocumentTemplate

Необязательный атрибут типа Integer. В настоящее время не используется. Допустим только в элементе ListTemplate, атрибут которого BaseType имеет значение 1 (библиотеки документов). Для обеспечения совместимости в будущем этот атрибут следует либо не устанавливать, либо он должен соответствовать атрибуту Type элемента DocumentTemplate в перечислении DocumentTemplates(аналогично предыдущей версии, но использование атрибута не рекомендуется).

DontSaveInTemplate

Необязательный атрибут типа Boolean. TRUE — исключить контент списка при сохранении списка как настраиваемого шаблона списка или при сохранении сайта, в который входит список, как настраиваемого шаблона сайта через пользовательский интерфейс.

EditPage

Необязательный атрибут типа Text. Определяет имя настраиваемой страницы приложения (/_layouts), которая будет использоваться в качестве страницы для редактирования свойств списков при создании списков посредством шаблона списка.

EnableModeration

Необязательный атрибут типа Boolean. TRUE — утверждение контента разрешено по умолчанию в списках, созданных посредством этого шаблона; FALSE — запрещено.

EnablePeopleSelector

Необязательный атрибут типа Boolean. Задает значение свойства EnablePeopleSelector.

EnableResourceSelector

Необязательный атрибут типа Boolean. Задает значение свойства EnableResourceSelector.

FeatureId

Необязательный атрибут типа Text. Определяет GUID, идентифицирующий компонент, с которым связан этот шаблон.

FolderCreation

Необязательный атрибут типа Boolean. TRUE — разрешить создание папок внутри списка и указать, что команда Создать папку должна отображаться в меню Создать в представлениях списка; FALSE — запретить создание папок.

Hidden

Необязательный атрибут типа Boolean. TRUE — указать, что определение списка не будет доступно на странице Создание при создании списков.

HiddenList

Необязательный атрибут типа Boolean. TRUE — указать, что список, созданный из определения списка, будет скрытым.

Image

Необязательный атрибут типа URL. Определяет URL-адрес значка, используемого для представления списка.

MultipleMtgDataList

Необязательный атрибут типа Boolean. Если указано MultipleMtgDataList="TRUE", это означает, что список на сайте рабочей области для собраний содержит данные для нескольких экземпляров собраний на этом сайте.

MultipleTypes

Необязательный атрибут типа Boolean. Задает наличие нескольких типов списков.

MustSaveRootFiles

Необязательный атрибут типа Boolean. TRUE — когда шаблон списка сохраняется без контента, сохранять страницы, находящиеся в специальной библиотеке документов, которая используется внутри сайта рабочей области для собраний. Этот атрибут не предназначен для общего доступа.

Name

Обязательный атрибут типа Text. Задает внутреннее имя определения списка. Нельзя использовать пробелы или специальные символы. Это имя также используется для поиска папки, содержащей файл Schema.xml, в котором определяется используемая схема.

NewPage

Необязательный атрибут типа Text. Задает имя настраиваемой страницы, используемой при создании нового списка посредством шаблона списка.

NoCrawl

Необязательный атрибут типа Boolean. TRUE — указать, что список не должен отображаться в результатах поиска; FALSE — разрешить отображение.

OnQuickLaunch

Необязательный атрибут типа Boolean. TRUE — отображать в панели Быстрыйзапуск списки, созданные на основе этого определения списка.

Path

Необязательный атрибут типа Text. Указывает имя определения сайта, которое содержит определение списка, например STS. Предполагается, что это путь относительно каталога 12\TEMPLATE. Путь может указывать на схему компонентов, например Features\Announcements (аналогично предыдущей версии, но использование атрибута не рекомендуется).

RootWebOnly

Необязательный атрибут типа Boolean. TRUE — указать, что список, созданный на основе этого определения, должен существовать только в корневом веб-сайте семейства сайтов (аналогично предыдущей версии, но использование атрибута не рекомендуется).

SecurityBits

Необязательный атрибут типа Text. Определяет разрешения для пользователей на чтение и изменение элементов списка. Атрибут SecurityBits содержит строку из двух цифр. Первая цифра в строке контролирует права на чтение, вторая цифра — права на изменение. Допустимые значения, определяющие права на чтение:

  • 1   Пользователи могут читать все элементы.

  • 2   Пользователи могут читать только свои собственные элементы.

Допустимые значения, определяющие права на изменение:

  • 1   Пользователи могут изменять все элементы.

  • 2   Пользователи могут изменять только свои собственные элементы.

  • 4   Пользователям запрещено изменять элементы.

ПримечаниеПримечание

Пользователи, имеющие разрешение ManageLists, могут читать и изменять все элементы независимо от значения атрибута SecurityBits.

Этот атрибут не применяется к библиотекам документов.

Sequence

Необязательный атрибут типа Integer. Задает приоритет при использовании шаблона списка на странице Создание. Если атрибут Sequence не установлен, шаблон отображается в группе таких же шаблонов, не имеющих значения Sequence. Шаблоны, которые определяют одну и ту же последовательность, также представляют группу. Внутри группы шаблоны упорядочиваются в случайном порядке.

SetupPath

Необязательный атрибут типа Text. Определяет путь к папке в каталоге установки SharePoint Foundation (%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\\TEMPLATE)), которая содержит файл для включения в данный шаблон.

SyncType

Необязательный атрибут типа Boolean. TRUE — переопределить тип списка клиентов по умолчанию, который связан с базовым шаблоном SharePoint Foundation.

Type

Необязательный атрибут типа Integer. Представляет уникальный идентификатор шаблона. Этот идентификатор должен быть уникальным внутри компонента, но не обязан быть уникальным во всех определениях компонентов или сайтов. Список типов шаблонов по умолчанию см. в описании типа SPListTemplateType.

Этот атрибут соответствует атрибуту Type элемента List.

Unique

Необязательный атрибут типа Boolean. TRUE — определение списка или шаблон списка можно использовать для создания списка только во время создания сайта и нельзя использовать для создания списка посредством объектной модели или пользовательского интерфейса после применения шаблона или определения сайта. Установка этого атрибута в TRUE приведет к тому, что список станет скрытым, поэтому он не появится на странице Создание и на странице Документы и списки.

UseRootFolderForNavigation

Необязательный атрибут типа Boolean. TRUE — ссылка на список, который отображается в панели Быстрый запуск будет указывать на корневую папку, поэтому пользователи перейдут на страницу приветствия, а не на страницу представления списков по умолчанию.

ПримечаниеПримечание

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

VersioningEnabled

Необязательный атрибут типа Boolean. TRUE — управление версиями по умолчанию разрешено в списках, созданных с помощью шаблона; FALSE — запрещено.

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

Нет

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

Элементы

Пример

Пример использования этого элемента см. в разделе Файлы шаблонов списков.