Элемент List (List)

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

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

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

Элемент верхнего уровня, содержащий определение списка.

<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

Необязательный атрибут типа Text. Для атрибута BaseType можно задать значение Integer, которое хранит значения в виде целых чисел, или значение Text (по умолчанию), которое хранит значения в виде текста. Обратите внимание, что нельзя создавать поля выбора на основе целочисленного типа.

Default

Необязательный атрибут типа Boolean. Значение TRUE означает, что при каждом создании сайта будет создаваться список, на который указывает ссылка в файле Onet.xml. В противном случае список не будет создаваться при создании сайта, но его экземпляр можно будет создать позже.

DefaultItemOpen

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

Description

Необязательный атрибут типа Text. Предоставляет описание списка. Этот атрибут должен указываться в файле Onet.xml конфигурации при добавлении настраиваемого определения списка в определение веб-сайта. Значение этого атрибута переопределяет значение, содержащееся в элементе DefaultDescription файла Schema.xml.

Direction

Обязательный атрибут типа Text. Указывает направление чтения списка. Возможные значения: RTL (справа налево), LTR (слева направо) или none.

DisableAttachments

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

DraftVersionVisibility

Необязательный атрибут типа Integer. Указывает значения, требуемые для просмотра черновиков. Допустимые значения:

  • 1 — право редактирования

  • 2 — право утверждения

  • Все остальные значения — право на чтение

EnableContentTypes

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

EnableMinorVersions

Необязательный атрибут типа Boolean.

EnableThumbnails

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

EventSinkAssembly

Необязательный атрибут типа Text. Это свойство указывается только для схем, обновленных с версии Windows SharePoint Services 2.0. Указывает строгое имя файла в глобальном кэше сборок, предоставляющего обработчик событий для событий библиотеки документов. Например, Microsoft.SharePoint, Version=11.0.0.0, Culture=Neutral, PublicKeyToken=71e9bce111e9429c. Этот атрибут был упразднен в SharePoint Foundation.

EventSinkClass

Необязательный атрибут типа Text. Указывает полное имя класса с учетом регистра, задающее обработчик событий для событий библиотеки документов, в формате Пространство_имен.Имя_класса. Этот атрибут был упразднен в SharePoint Foundation.

EventSinkData

Необязательный атрибут типа Text. Содержит произвольную строку, используемую обработчиком событий для событий библиотеки документов. Этот атрибут был упразднен в SharePoint Foundation.

FolderCreation

Необязательный атрибут типа Boolean. Значение TRUE используется для отображения команды Создать каталог в меню Создать.

Id

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

ModeratedList

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

ModerationType

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

Name

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

OrderedList

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

PrivateList

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

QuickLaunchUrl

Необязательный атрибут типа Text. Указывает URL-адрес просматриваемой страницы для открытия для списка через панель "Быстрого запуска".

RootWebOnly

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

ThumbnailSize

Необязательный атрибут типа Integer. Указывает ширину эскизов, отображаемых в библиотеке рисунков.

Title

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

Type

Необязательный атрибут типа Integer. Указывает тип шаблона списка. Далее приведены значения типов шаблонов списка по умолчанию.

  • 100 — стандартный список

  • 101 — библиотека документов

  • 102 — опрос

  • 103 — список ссылок

  • 104 — список извещений

  • 105 — список контактов

  • 106 — список событий

  • 107 — список задач

  • 108 — доска обсуждений

  • 109 — библиотека рисунков

  • 110 — источники данных

  • 111 — галерея шаблонов сайтов

  • 112 — список сведений о пользователях

  • 113 — галерея веб-частей

  • 114 — галерея шаблонов списков

  • 115 — библиотека XML-форм

  • 116 — галерея главных страниц

  • 117 — рабочие процессы без кода

  • 118 — настраиваемый рабочий процесс

  • 119 — библиотека вики-страниц

  • 120 — настраиваемая сетка для списка

  • 130 — библиотека подключений к данным

  • 140 — журнал рабочего процесса

  • 150 — список задач Ганта

  • 200 — список рядов собраний

  • 201 — повестка собрания

  • 202 — список участников собрания

  • 204 — список решений собрания

  • 207 — список целей собрания

  • 210 — текстовое поле собрания

  • 211 — список необходимых вещей на собрании

  • 212 — список страниц рабочей области собрания

  • 301 — список записей блога

  • 302 — список комментариев блога

  • 303 — список категорий блога

  • 1100 — отслеживание вопросов

  • 1200 — список задач администратора

Этот атрибут относится к атрибуту Type элемента ListTemplate.

Url

Необязательный атрибут типа Text.

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

URLEncode

Необязательный атрибут типа Boolean. Значение TRUE используется для преобразования специальных символов (например, пробелов) в символы UTF-8, заключенные в кавычки; например "%c3%ab" для буквы "ё".

VersioningEnabled

Необязательный атрибут типа Boolean. Значение TRUE в файле Schema.xml указывает, что управление версиями по умолчанию включено для библиотек документов, создаваемых с помощью определения списка. Изменение этого атрибута не влияет на уже имеющиеся библиотеки документов. Даже если установлено значение TRUE, то управление версиями для библиотеки документов можно отключить при ее создании на странице "Новая библиотека документов".

WebImageHeight

Необязательный атрибут типа Integer. Указывает высоту изображения в библиотеке рисунков в пикселах.

WebImageWidth

Необязательный атрибут типа Integer. Указывает ширину изображения в библиотеке рисунков в пикселах.

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

MetaData

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

Нет

Вхождения

Минимум: 0

Максимум: 1

Примечания

При использовании в качестве корневого элемента в файле схемы для списка элемент List должен содержать объявление пространства имен Microsoft SharePoint Foundationows:. В следующих строках показано открытие файла 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, позволяющий указывать значения столбцов по умолчанию для заданного типа списка.