Элемент List (List)
Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013
Элемент верхнего уровня, содержащий определение списка.
<List
BaseType = "Integer" | "Text"
Default = "TRUE" | "FALSE"
DefaultItemOpen = "Integer"
Description = "Text"
Direction = "Text"
DisableAttachments = "TRUE" | "FALSE"
DraftVersionVisibility = "Integer"
EnableContentTypes = "TRUE" | "FALSE" EnableMinorVersions = "TRUE" | "FALSE" EnableThumbnails = "TRUE" | "FALSE"
EventSinkAssembly = "Text"
EventSinkClass = "Text"
EventSinkData = "Text"
FolderCreation = "TRUE" | "FALSE"
Id = "GUID"
ModeratedList = "TRUE" | "FALSE"
ModerationType = "TRUE" | "FALSE"
Name = "Text"
OrderedList = "TRUE" | "FALSE"
PrivateList = "TRUE" | "FALSE"
QuickLaunchUrl = "URL"
RootWebOnly = "TRUE" | "FALSE"
ThumbnailSize = "Integer"
Title = "Text"
Type = "Integer"
Url = "URL"
URLEncode = "TRUE" | "FALSE"
VersioningEnabled = "TRUE" | "FALSE"
WebImageHeight = "Integer"
WebImageWidth = "Integer">
</List>
Элементы и атрибуты
В разделах ниже приводится описание атрибутов, дочерних и родительских элементов.
Атрибуты
| Атрибут | Описание |
|---|---|
| Basetype |
Необязательный текст. Для атрибута BaseType можно задать значение Integer, которое хранит значения в виде целых чисел, или значение Text (по умолчанию), которое хранит значения в виде текста. Обратите внимание, что нельзя создавать поля выбора на основе целочисленного типа. |
| По умолчанию |
Необязательный логический. Значение TRUE означает, что при каждом создании сайта будет создаваться список, на который указывает ссылка в файле Onet.xml. В ином случае список не будет создаваться при создании сайта, но его можно будет установить в последствии. |
| DefaultItemOpen |
Необязательный логический. Значение 1 означает, что приложения, генерирующие серверные преобразования элементов списка, открывают элементы в браузере, а не в отдельном клиентском приложении; в ином случае устанавливается значение 0. |
| Описание |
Необязательный атрибут типа Text. Предоставляет описание списка. Этот атрибут должен указываться в конфигурации файла Onet.xml при добавлении пользовательского определения списка в определение сайта. Значение этого атрибута переопределяет значение, содержащееся в элементе DefaultDescription файла Schema.xml. |
| Направление |
Обязательный атрибут типа Text. Указывает направление чтения списка. Возможные значения: RTL (справа налево), LTR (слева направо) или none. |
| DisableAttachments |
Необязательный логический. Значение TRUE используется, чтобы выключить вложения в списке. |
| DraftVersionVisibility |
Необязательный атрибут типа Integer. Указывает значения, требуемые для просмотра черновиков. Допустимые значения: - 1 Права на изменение - 2 Права утверждения - Все остальные значения Права на чтение |
| EnableContentTypes |
Необязательный логический. Значение TRUE используется, чтобы включить управление типами контента в списках, созданных в определении списка. |
| EnableMinorVersions |
Необязательный логический. |
| EnableThumbnails |
Необязательный логический. Значение TRUE указывает, что анализаторы документов в этом списке генерируют файлы эскизов, соответствующие сохраняемым в этот список документам. Этот атрибут применим только к библиотекам документов. |
| EventSinkAssembly |
Необязательный текст. Этот параметр указан только для схем, обновленных с Windows SharePoint Services 2.0. Задает строгое имя файла в глобальном кэше сборок (GAC), который предоставляет обработчик событий для событий библиотеки документов. Пример: Microsoft.SharePoint, Version=11.0.0.0, Culture=Neutral, PublicKeyToken=71e9bce111e9429cЭтот атрибут устарел в SharePoint Foundation. |
| EventSinkClass |
Необязательный текст. Указывает полное имя класса с учетом регистра, которое определяет обработчик событий для событий библиотеки документов в форме Namespace_Name.Class_Name. Этот атрибут устарел в SharePoint Foundation. |
| EventSinkData |
Необязательный текст. Содержит произвольную строку для использования обработчиком событий для событий библиотеки документов. Этот атрибут устарел в SharePoint Foundation. |
| FolderCreation |
Необязательный логический. Значение TRUE используется для отображения команды Создать каталог в меню Создать. |
| Id |
Необязательный атрибут типа GUID. Указывает идентификатор GUID списка. |
| ModeratedList |
Необязательный логический. Значение TRUE используется для требования утверждения контента для добавленных элементов. |
| ModerationType |
Необязательный логический. Значение TRUE указывает, что в списке включено утверждение, требующее выполнения процесса утверждения при создании или изменении контента. |
| Имя |
Обязательный атрибут типа Text. Внутреннее имя списка. |
| Упорядоченный список |
Необязательный логический. Значение TRUE указывает, что доступно свойство, позволяющее пользователям реорганизовывать элементы списка, на странице изменения представления для списка. |
| PrivateList |
Необязательный логический. Значение TRUE указывает, что список является частным. |
| QuickLaunchUrl |
Необязательный атрибут типа Text. Указывает URL-адрес открываемой страницы представления для списка с использованием переходов панели быстрого запуска. |
| RootWebOnly |
Необязательный логический. ЗНАЧЕНИЕ TRUE , чтобы указать, что список, созданный на основе определения, существует только на корневом веб-сайте семейства веб-сайтов. |
| Эскизы |
Необязательный атрибут типа Integer. Указывает ширину эскизов, отображаемых в библиотеке рисунков. |
| Title |
Обязательный атрибут типа Text. Стандартное отображаемое имя списка. |
| Тип |
Необязательный атрибут типа Integer. Указывает тип шаблона списка. Далее приведены значения типов шаблонов списка по умолчанию. Универсальный список 100 Библиотека документов 101 Опрос 102 Список ссылок 103 Список объявлений 104 Список контактов 105 Список событий 106 Список задач 107 Доска обсуждений 108 Библиотека рисунков 109 110 Источники данных Коллекция шаблонов сайтов 111 Список сведений о пользователях 112 Коллекция веб-частей 113 Коллекция шаблонов списка 114 Библиотека xml-форм 115 Коллекция 116 эталонных страниц 117 рабочих процессов No-Code 118 Пользовательский рабочий процесс Библиотека вики-страницы 119 120 Настраиваемая сетка для списка Библиотека подключения к данным 130 140 Журнал рабочих процессов Список задач Ганта : 150 Список рядов собраний 200 Список повестки дня собрания 201 Список участников собрания 202 Список решений для собраний 204 Список целей собрания 207 210 Текстовое поле "Собрание" 211 . Список "Вещи для собрания" Список страниц рабочей области собрания 212 Список записей блога 301 Список комментариев блога 302 Список категорий блога 303 1100 Отслеживание проблем Список задач администратора 1200 Этот атрибут относится к атрибуту Type элемента ListTemplate. |
| Url |
Необязательный текст. Указывает путь к корню каталога, содержащего ASPX-файлы, к которым применяется определение списка, относительно корневого URL-адреса веб-сайта. |
| URLEncode |
Необязательный логический. ЗНАЧЕНИЕ TRUE для преобразования специальных символов, таких как пробелы, в формат UTF-8 с кавычками, например %c3%ab для символа ë. |
| Управление версиямиEnabled |
Необязательный логический. Значение TRUE указывает внутри файла Schema.xml, что управление версиями по умолчанию включено для библиотек документов, создаваемых через определение списка. Изменение этого атрибута не влияет на уже имеющиеся библиотеки документов. Если установлено значение TRUE, то управление версиями все равно можно отключить для библиотеки документов на странице "Новая библиотека документов" при создании библиотеки. |
| WebImageHeight |
Необязательный атрибут типа Integer. Указывает высоту изображения в библиотеке рисунков в пикселах. |
| WebImageWidth |
Необязательный атрибут типа Integer. Указывает ширину изображения в библиотеке рисунков в пикселах. |
Дочерние элементы
Родительские элементы
Нет
Occurrences
- Минимум: 0
- Максимум: 1
Замечания
При использовании в качестве корневого элемента в файле схемы для списка элемент List должен содержать объявление пространства имен Microsoft SharePoint Foundation ows: . Следующие строки демонстрируют начало открытия файла Schema.xml для библиотек документов:
<List
xmlns:ows="Microsoft SharePoint"
Name="Documents"
Title="$Resources:shareddocuments_Title;"
Direction="$Resources:Direction;"
Url="Shared Documents"
BaseType="1">
В схеме списка элемент MetaData содержит различные части определения списка. Используйте пустой элемент List (<List />) для возврата заголовка текущего списка.
В определении сайта (Onet.xml) элемент List не содержит раздела MetaData, но может содержать раздел Data, с помощью которого можно указывать значения столбцов по умолчанию для заданного типа списка.