Элемент Field (List)

Статья
04/08/2023

Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Определяет внутренние типы данных, используемые в инфраструктуре списка веб-сайта SharePoint. Поле представляет собой столбец или атрибут данных, который пользователь может добавить в список.

<Field
  Aggregation = "sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion = "TRUE" | "FALSE"
  AllowHyperlink = "TRUE" | "FALSE"
  AllowMultiVote = "TRUE" | "FALSE"
  AppendOnly = "TRUE" | "FALSE"
  AuthoringInfo = "Text"
  BaseType = "Integer" | "Text"
  CalType = "Integer"
  CanToggleHidden = "TRUE" | "FALSE"
  ClassInfo = "Text"
  ColName = "Text"  ColName2 = "Text"
  Commas = "TRUE" | "FALSE"
  Customization = "Text"
  Decimals = "Integer"
  Description = "Text"
  Dir = "Text"
  Direction = "Text"
  DisplaceOnUpgrade = "TRUE" | "FALSE"
  DisplayImage = "Text"
  DisplayName = "Text"
  DisplayNameSrcField = "Text"
  DisplaySize = "Integer"
  Div = "Number"
  EnableLookup = "TRUE" | "FALSE"
  EnforceUniqueValues = "TRUE" | "FALSE"
  ExceptionImage = "Text"
  FieldRef = "Text"
  FillInChoice = "TRUE" | "FALSE"
  Filterable = "TRUE" | "FALSE"
  FilterableNoRecurrence = "TRUE" | "FALSE"
  ForcedDisplay = "Text"
  ForcePromoteDemote = "TRUE" | "FALSE"
  Format = "Text"
  FromBaseType = "TRUE" | "FALSE"
  Group = "Text"
  HeaderImage = "Text"
  Height = "Integer"
  Hidden = "TRUE" | "FALSE"
  HTMLEncode = "TRUE" | "FALSE"
  ID = "Text"  Id = "Text"
  IMEMode = "inactive"
  Indexed = "TRUE" | "FALSE"
  IsolateStyles = "TRUE" | "FALSE"
  IsRelationship = "TRUE" | "FALSE"
  JoinColName = "Text"
  JoinRowOrdinal = "Integer"
  JoinType = "INNER" | "LEFT OUTER" | "RIGHT OUTER"
  LCID = "Integer"  LinkToItem = "TRUE" | "FALSE"
  LinkToItemAllowed = "Text"
  List = "Text"
  ListItemMenu = "TRUE" | "FALSE"
  ListItemMenuAllowed = "Text"
  Max = "Number"
  MaxLength = "Integer"
  Min = "Number"
  Mult = "TRUE" | "FALSE"
  Name = "Text"
  NegativeFormat = "MinusSign" | "Parens"
  Node = "Text"
  NoEditFormBreak = "TRUE" | "FALSE"
  NumLines = "Integer"
  Percentage = "TRUE" | "FALSE"
  PIAttribute = "Text"
  PITarget = "Text"
  PrependId = "TRUE" | "FALSE"
  Presence = "TRUE" | "FALSE"
  PrimaryKey = "TRUE" | "FALSE"
  PrimaryPIAttribute = "Text"
  PrimaryPITarget = "Text"
  ReadOnly = "TRUE" | "FALSE"
  ReadOnlyEnforced = "TRUE" | "FALSE"
  RelationshipDeleteBehavior = "Text"
  RenderXMLUsingPattern = "TRUE" | "FALSE"
  Required = "TRUE" | "FALSE"
  RestrictedMode = "TRUE" | "FALSE"
  ResultType = "Text"
  RichText = "TRUE" | "FALSE"
  RichTextMode = "Text"
  RowOrdinal = "Integer"
  Sealed = "TRUE" | "FALSE"
  SeparateLine = "TRUE" | "FALSE"
  SetAs = "Text"
  ShowAddressBookButton = "TRUE" | "FALSE"
  ShowAlways = "TRUE" | "FALSE"
  ShowField = "Text" | "Choice" | "Counter"
  ShowInDisplayForm = "TRUE" | "FALSE"
  ShowInEditForm = "TRUE" | "FALSE"
  ShowInFileDlg = "TRUE" | "FALSE"
  ShowInListSettings = "TRUE" | "FALSE"
  ShowInNewForm = "TRUE" | "FALSE"
  ShowInVersionHistory = "TRUE" | "FALSE"
  ShowInViewForms = "TRUE" | "FALSE"
  Sortable = "TRUE" | "FALSE"
  SourceID = "Text"
  StaticName = "Text"
  StorageTZ = "UTC" | "Abstract"
  StripWS = "TRUE" | "FALSE"
  SuppressNameDisplay = "TRUE" | "FALSE"
  TextOnly = "TRUE" | "FALSE"
  Title = "Text"
  Type = "Data_Type"
  UniqueId = "Text"
  UnlimitedLengthInDocumentLibrary = "TRUE" | "FALSE"
  URLEncode = "TRUE" | "FALSE"
  URLEncodeAsUrl = "TRUE" | "FALSE"
  UserSelectionMode = "Text"
  UserSelectionScope = "Integer"
  Version = "Text"
  Viewable = "TRUE" | "FALSE"
  WebId = "Text"
  Width = "Integer"
  WikiLinking = "TRUE" | "FALSE"
  XName = "Text">
</Field>

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

В следующих разделах описаны атрибуты, дочерние элементы и родительские элементы.

Атрибуты

Атрибут	Описание
Агрегации	Необязательный атрибут типа Text. Используется в агрегатном поле XML-формы для указания функции, применяемой к коллекции значений или элементов, возвращенных выражением XPath. Если используется атрибут Node для указания выражения XPath, возвращающего коллекцию значений, можно также включить атрибут Aggregation, указывающий действие для выполнения над возвращенным набором значений. Этим действием может быть агрегатная функция или указатель определенного элемента в коллекции. Возможны следующие значения: - Сумма Добавьте значения. - Рассчитывать Подсчитайте количество значений. - Средняя Найдите среднее значение значений. - Мин Найдите минимальное значение. - Макс Найдите максимальное значение. - Объединить Объединить значения. - Plaintext Преобразует текстовое содержимое узла в обычный текст. - Первый Примените повышение и понижение свойств к первому элементу в коллекции. - Последний Примените повышение и понижение свойств к последнему элементу в коллекции. Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, PrimaryPIAttribute и PrimaryPITarget для повышения и понижения свойств в XML-документах см. в разделе Using Content Types to Specify XML Document Properties.
AllowDeletion	Необязательный логический. Имеет значение TRUE, если поле может быть удалено.
AllowHyperlink	Необязательный логический. Имеет значение TRUE, если разрешено использование гиперссылок в поле.
AllowMultiVote	Необязательный логический. Имеет значение TRUE, если разрешено несколько ответов в опросе.
AppendOnly	Необязательный логический. Если в списке включено управление версиями, значение TRUE разрешает только добавление текста к существующему тексту в поле Note.
AuthoringInfo	Необязательный текст. Строка описания, которая отображается на странице редактирования полей для идентификации поля и его задач; например, поле LinkTitle содержит сведения о разработке "(ссылка на элемент)". Данный атрибут, как правило, используется в случае, если существующее поле с тем же именем служит для других целей.
Basetype	Необязательный параметр. Атрибут BaseType может иметь значение Integer для хранения значений в виде целых чисел или значение Text (по умолчанию) для хранения значений в виде текста. Создание полей выбора с целочисленным базовым типом невозможно.
CalType	Необязательный атрибут типа Integer. Указывает тип календаря. Возможны следующие значения: 16 Эра Сака 15 китайский лунный 14 корейских и японских лунных 12 григорианский транслитерированный французский 11 григорианский транслитерированный английский 10 григорианский арабский 9 Григорианский ближневосточный французский 8 Иврит (лунный) 7 Тайский 6 Хиджри (арабский лунный) 5 Корейский тангун эры 4 Тайваньская эра 3 Эпоха японского императора 1 григорианский 0 Тип не указан
CanToggleHidden	Необязательный логический. Имеет значение TRUE, если поле может быть скрыто через пользовательский интерфейс.
ClassInfo	Необязательный атрибут типа Text. Указывает класс каскадной таблицы стилей (CSS) для данного поля в стандартном представлении таблицы. Если задан, указанный класс используется вместо стандартного класса ms-vb2.
ColName	Необязательный атрибут типа Text. Внутренний атрибут, определяющий сопоставление поля с именем физического хранилища для данного поля. Это должно быть действительное имя в основной базе данных, идентичное имени, которое используется в таблице базы данных. Если не указано, сервер создает имя столбца, не конфликтующее с существующими именами столбцов и содержащее только символы, разрешенные Microsoft SQL Server.
ColName2	Необязательный текст.
Запятыми	Необязательный логический. Имеет значение TRUE, если для разделения разрядов тысяч используются запятые.
Настройка	Необязательный текст.
Десятичные дроби	Необязательный атрибут типа Integer. Обозначает количество десятичных знаков для отображения. Отображаемое значение округляется в большую сторону; например, 1,05 при округлении до одного десятичного знака отображается как 1,1.
Описание	Необязательный атрибут типа Text. Предоставляет описание, отображаемое в форме редактирования для списка, если указано описание поля. По умолчанию поля в Microsoft SharePoint Foundation не имеют описаний.
Dir	Необязательный атрибут типа Text. Указывает направление текста для поля, поддерживающего двунаправленный порядок чтения. Возможные значения: LTR (слева направо), RTL (справа налево) и none.
Направление	Необязательный текст.
DisplaceOnUpgrade	Необязательный логический. Если для поля уже существует определение, значение TRUE задает обновление свойств поля с использованием значений, указанных в этом определении поля.
DisplayImage	Необязательный атрибут типа Text. Указывает имя значка, отображаемого для столбца.
DisplayName	Необязательный атрибут типа Text. Отображаемое имя поля. Ограничений для размера текста или использования пробелов нет. Отображаемое имя может изменяться пользователем; его можно изменить после изначального создания поля. Это имя используется как заголовок столбца при отображении поля в представлении таблицы и как метка формы при отображении поля в форме. Тег <FieldName/> возвращает отображаемое имя, если задано; в противном случае по умолчанию используется атрибут Name .
DisplayNameSrcField	Необязательный атрибут типа Text. Обычно используется для вычисляемого поля, которому необходимо такое же имя, как и у другого поля. Если изменяется исходное поле и пользователь изменяет отображаемое имя, имя этого поля также редактируется. Эта строка ссылается на имя другого поля.
DisplaySize	Необязательное целое число.
Div	Необязательный атрибут типа Number. Коэффициент масштабирования, используемый при делении перед отображением числа. Отображаемое число — `N * Mult / Div` (округляется до числа, указанного в десятичных числах).
EnableLookup	Необязательный логический. Значение TRUE разрешает использование значений подстановки в поле.
EnforceUniqueValues	Необязательный логический.
ExceptionImage	Необязательный текст. Используется в типе поля Recurrence для указания имени файла изображения, используемого для исключений.
FieldRef	Необязательный атрибут типа Text. Обозначает имя другого поля, на которое ссылается поле; например, поле "Поиск".
FillInChoice	Необязательный логический. Имеет значениеTRUE, если поле допускает заполнение пользователями значений для столбца.
Filterable	Необязательный логический. Имеет значение TRUE, если разрешена фильтрация поля.
FilterableNoRecurrence	Необязательный логический. Имеет значение TRUE, если может быть создан фильтр для поля в представлении без развертывания повторяющихся событий. Если атрибут Filterable содержит значение TRUE, фильтрация поля возможна во всех представлениях, независимо от значения атрибута FilterableNoRecurrence.
ForcedDisplay	Необязательный атрибут типа Text. Указывает текст для отображения вместо фактического значения поля. Этот атрибут используется в опросах для предотвращения отображения имени пользователя.
ForcePromoteDemote	Необязательный логический.
Format	Необязательный атрибут типа Text. Указывает форматирование для числовых значений. Для полей даты и времени возможны следующие значения: - DateOnly Отображение (и разрешение редактирования) только части даты (для всех измененных значений для временной части задано значение 12:00). - Datetime Отображение и изменение даты и времени суток (по умолчанию). - ISO8601 Отображение даты и времени в формате времени ISO8601, преобразованном в формат UTC: ГГГГ-ММ-ДДЧЧ:ММ:ССЗ. Этот формат используется для свойств документов в системе Microsoft Office 2007, а также для стандартного формата обмена, используемого в SharePoint Foundation между формами "Создать" и "Изменить" и сервером. - ISO8601Basic Используйте сокращенную форму форматов даты и времени 8601: ГГГГМММДДДTHHMMSSZ. Этот формат используется для vCard или iCal. Для полей выбора этот атрибут может иметь значение Dropdown (по умолчанию), которое предоставляет варианты изменения в раскрывающемся списке, или RadioButtons, предоставляющее варианты в виде группы переключателей. Для полей URL-адреса для этого атрибута можно задать значение Гиперссылка (по умолчанию), в котором URL-адрес отображается как обычный `<A>` тег, или значение Image, в котором URL-адрес отображается как `<IMG SRC="URL" ALT="Description">`.
FromBaseType	Необязательный логический. Этот атрибут заменен атрибутом Sealed.
Group	Необязательный атрибут типа Text. Указывает группу столбцов, к которой принадлежит данное поле.
HeaderImage	Необязательный атрибут типа Text. Указывает имя файла изображения для использования в качестве заголовка поля.
Height	Необязательный атрибут типа Integer. Указывает высоту изображений, которые отображаются для пользователей в списке сведений о пользователе, в пикселях.
Hidden	Необязательный логический. При значении TRUE поле полностью скрыто для пользовательского интерфейса. Указание для атрибута ReadOnly значения TRUE означает, что поле не отображается в формах создания или изменения, но может быть включено в представления.
Htmlencode	Необязательный логический. TRUE, чтобы выполнить преобразование внедренных символов для отображения их в браузере в виде текста; символы, похожие на HTML-теги, преобразуются в логические объекты.
ID	Необязательный текст. Указывает GUID поля, содержащегося в фигурных скобках ({}).
Id	Необязательный текст.
IMEMode	Необязательный атрибут типа Text. Задает смещение режима IME для использования в поле. Редактор метода ввода позволяет использовать одни и те же клавиши при работе с несколькими языками, когда одна система письма имеет больше символов, чем может быть закодировано для данной клавиатуры. Возможны следующие значения: - Авто Не используется. Чтобы указать этот режим IME, задайте для свойства IMEMode пустую строку (`""`). - Активных Все символы вводятся через IME, но пользователи по-прежнему могут деактивировать IME. - Неактивные Символы вводятся без IME, хотя пользователи по-прежнему могут активировать IME.
Indexed	Необязательный логический. Имеет значение TRUE, если столбец индексирован для использования в фильтрах представления.
IsolateStyles	Необязательный логический. Для поля Text, атрибут RichText которого имеет значение TRUE, а атрибут RichTextMode — значение FullHtml, этот атрибут указывает, что сервер будет перезаписывать HTML данного поля, чтобы исключить помехи при отрисовке окружающей страницы.
IsRelationship	Необязательный логический. Значение TRUE , если поле можно обнаружить из списка, в котором оно ищет его значение.
JoinColName	Необязательный атрибут типа Text. Этот атрибут определен только для полей подстановки. Он очень похож на ColName, за исключением того, что указывает имя столбца, которое используется в инструкции JOIN SQL для локальных и внешних списков. Как правило, это значение не следует настраивать. В настоящее время оно используется только в схеме Field определенных встроенных и базовых полей для указания подстановок в таблицу URL-адресов (DocMd), которая связана со столбцом UrlID.
JoinRowOrdinal	Необязательный атрибут типа Integer. Не для использования непосредственно из кода.
JoinType	Необязательный атрибут типа Text. Указывает тип JOIN для поля. Возможные значения: INNER, LEFTOUTER и RIGHTOUTER.
Код языка	Необязательное целое число. Атрибут LCID может использоваться для указания страны и региона, формат валюты которых используется, например 1033 для США. В двух случаях используется знак "евро". Если LCID = -1 (0xFFFFFFF), символ "евро" добавляется в качестве префикса к числу. Если LCID = -2 (0xFFFFFFE), знак "евро" добавляется к числу в качестве суффикса. Количество десятичных знаков — 2, хотя это может быть переопределено атрибутом Decimals поля. Символ валюты евро в UCS-2 — 0x20AC.
LinkToItem	Необязательный логический.
LinkToItemAllowed	Необязательный текст.
List	Необязательный атрибут типа Text. Указывает внутреннее имя списка.
ListItemMenu	Необязательный логический.
ListItemMenuAllowed	Необязательный текст.
Max	Необязательный атрибут типа Number. Указывает максимально допустимое значение поля.
MaxLength	Необязательный атрибут типа Integer. Задает максимальное число знаков, допустимое в значении поля. Формы редактирования приводятся в соответствие с этим значением, которое проверяется в клиентском приложении. При попытке ввести больше знаков, чем задано в параметре MaxLength, отображается сообщение об ошибке.
Min	Необязательный атрибут типа Number. Указывает минимальное допустимое значение поля.
Мульт	Необязательный логический. Масштабный коэффициент, используемый при умножении до отображения числа.
Имя	Обязательный атрибут типа Text. Имя поля. Это внутреннее имя поля, которое не подлежит каким-либо изменениям в ходе жизненного цикла определения поля. Имя должно быть уникальным в наборе полей в списке. Имя создается автоматически на основе имени поля, заданного пользователем.
Отрицательный формат	Необязательный атрибут типа Text. Указывает способ обозначения отрицательных значений. Может иметь одно из следующих значений: - MinusSign Используйте знак "минус" в качестве префикса. - Паренс Окружите круглыми скобками.
Node	Необязательный текст. Этот атрибут, используемый в XML-формах, является обязательным для всех полей, кроме ссылок инструкций обработки (PI), и указывает выражение XPath для узла, который повышен.
NoEditFormBreak	Необязательный логический. Значение TRUE запрещает добавление разрывов строк между полями в формах создания или изменения элементов. Некоторые типы полей, такие как поля форматированного текста, задают интервалы по умолчанию, а этот атрибут позволяет контролировать получающиеся дополнительные интервалы.
NumLines	Необязательный атрибут типа Integer. Рекомендует число строк для отображения в блоке TEXTAREA при редактировании. Это просто подсказка в клиентском пользовательском интерфейсе — никакого ограничения по числу строк редактируемого текста не существует.
Percentage	Необязательный логический. Значение TRUE используется, если значение отображается в процентных долях; то есть в виде числа, умноженного на 100 с добавленным знаком процента (%).
PIAttribute	Необязательный текст. Указывает атрибут в инструкции по обработке документа (заданный атрибутом PITarget) для использования в качестве значения столбца. Используется для повышения и понижения уровня свойств в XML-документах. Если указан атрибут PIAttribute, необходимо также указать атрибут PITarget. Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения уровня свойств в XML-документах см. в статье Using Content Types to Specify XML Document Properties.
PITarget	Необязательный атрибут типа Text. Указывает инструкцию по обработке документа, в которой значение столбца хранится в документах данного типа контента. Используется для повышения и понижения уровня свойств в XML-документах. Если указан атрибут PIAttribute, необходимо также указать атрибут PITarget. Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения уровня свойств в XML-документах см. в статье Using Content Types to Specify XML Document Properties.
PrependId	Необязательный логический. Используется в списках отслеживания проблем , значение TRUE для отображения идентификаторов коллекций связанных элементов проблем в формах редактирования и создания элементов.
Присутствие	Необязательный логический. Имеет значение TRUE при наличии сведений о пользователе для поля.
PrimaryKey	Необязательный логический. Имеет значениеTRUE, если поле является первичным ключом в отношении между списками.
PrimaryPIAttribute	Необязательный атрибут типа Text. Используется для повышения и понижения уровня свойств в XML-документах. Указывает альтернативный атрибут в инструкции по обработке документа, заданной атрибутом PrimaryPITarget, для использования в качестве значения столбца. Если указан атрибут PrimaryPIAttribute, необходимо также указать атрибут PrimaryPITarget. Если это указано, SharePoint Foundation использует эти значения перед значениями, указанными в атрибутах PITarget и PIAttribute . Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения уровня свойств в XML-документах см. в статье Using Content Types to Specify XML Document Properties.
PrimaryPITarget	Необязательный атрибут типа Text. Указывает альтернативную инструкцию по обработке документа, в которой значение столбца хранится в документах данного типа контента. Если указан атрибут PrimaryPIAttribute, необходимо также указать атрибут PrimaryPITarget. Если это указано, SharePoint Foundation использует эти значения перед значениями, указанными в атрибутах PITarget и PIAttribute . Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для повышения и понижения уровня свойств в XML-документах см. в статье Using Content Types to Specify XML Document Properties.
ReadOnly	Необязательный логический. При значении TRUE поле не отображается в формах создания и изменения, но может быть включено в представления. Кроме того, установка для атрибута ReadOnly значения TRUE скрывает поле со страниц параметров сайта для управления столбцами и типами контента сайта. Установка для атрибута Hidden значения TRUE полностью скрывает поле из пользовательского интерфейса. Если этот атрибут не включен, SharePoint Foundation обрабатывает столбец так, как если бы для этого атрибута задано значение False.
ReadOnlyEnforced	Необязательный логический. Значение TRUE указывает, что поле может изменять только система, не пользователь.
RelationshipDeleteBehavior	Необязательный текст. Указывает поведение удаления поля. Возможные значения: Cascade, Restrict и None.
RenderXMLUsingPattern	Необязательный логический. Используется в случае вычисляемых полей для определения формата отображения. При значении TRUE значения отображаются на основе шаблона вычисляемого поля, а не значения столбца ссылки на первое невычисляемое поле, на котором основано вычисляемое поле. Например, в библиотеке изображений столбец "Размер изображения" представлен значениями ширина x высота, но если для этого атрибута не задано значение TRUE, отображается только ссылка на первое поле, ширина. Если задано значение TRUE, отображается формат ширина x высота.
Required	Необязательный логический. При значении TRUE поле не должно иметь назначенных ему пустых значений. Если значение поля nonempty не задано в записи формы, в форме ошибки отображается либо стандартный текст обязательного поля, либо явно указанное сообщение (т. е. с помощью <тегов ErrorText> ). Эту проверку выполняет только клиент (база данных всегда допускает значения NULL для всех пользовательских полей).
RestrictedMode	Необязательный логический. Значение TRUE запрещает использование в поле Note расширенного форматирования текста, такого как изображения, таблицы или гиперссылки, а также запрещает вставку форматированного текста в это поле.
ResultType	Необязательный атрибут типа Text. Указывает типы данных значений, возвращаемых из поля.
RichText	Необязательный логический. Имеет значение TRUE, если поле отображает форматирование текста.
RowOrdinal	Необязательный атрибут типа Integer. Указывает расположение базы данных для поля.
Запечатаны	Необязательный логический. Если данному атрибуту присваивается значение TRUE для поля в файле Schema.xml для списка, поле помечается на странице "Изменить столбец" как неудаляемое.
SeparateLine	Необязательный логический. Используется для внутренней поддержки отрисовки поля (например, "Примечания" или "Заметки") в отдельной строке. Этот атрибут не предназначен для общего использования.
SetAs	Не для использования непосредственно из кода.
ShowAddressBookButton	Не для использования непосредственно из кода.
ShowAlways	Необязательный логический.
ShowField	Необязательный параметр. Для атрибута ShowField можно задать отображение имени поля. По умолчанию отображается текст с гиперссылкой из поля "Заголовок" записи во внешнем списке. Но атрибут ShowField можно использовать для переопределения и отображения другого поля из внешнего списка. Следующие типы данных можно использовать как целевые в атрибуте ShowField: Text, Choice и Counter. Для поля Lookup можно настроить данный параметр как внутреннее имя поля; если настроить его как отображаемое имя, это не приведет к ошибке, но целостность поля будет нарушена.
ShowInDisplayForm	Необязательный логический. Значение TRUE отображает поле в форме для просмотра элемента.
ShowInEditForm	Необязательный логический. Значение TRUE отображает поле в форме для изменения элемента.
ShowInFileDlg	Необязательный логический. Этот атрибут допустим только для полей в схемах библиотеки документов. При значении FALSE поле не отображается в диалоговом окне свойств для сохранения форм, отображаемых при сохранении из клиентских приложений. Например, поле заголовка имеет этот атрибут, так как задается непосредственно в документе, который сохраняется в библиотеке документов.
ShowInListSettings	Необязательный логический. Значение TRUE отображает столбец на странице для настройки параметров списка.
ShowInNewForm	Необязательный логический. При значении FALSE поле не отображается в перечислении Fields, когда задан режим отображения New. Поля с этим параметром не отображаются на странице создания элемента по умолчанию для данного списка. В частности, это используется для скрытия полей на странице для передачи документов в библиотеку документов.
ShowInVersionHistory	Необязательный логический. При значении TRUE столбец отображается на странице для просмотра версий элемента списка.
ShowInViewForms	Необязательный логический. При значении TRUE поле отображается на страницах, используемых для просмотра данных списка.
Возможность сортировки	Необязательный логический. Имеет значение TRUE, если возможна сортировка значений в поле.
SourceID	Необязательный текст. Содержит пространство имен, определяющее поле, например `http://schemas.microsoft.com/sharepoint/v3`, или GUID списка, в котором было создано настраиваемое поле.
StaticName	Необязательный атрибут типа Text. Содержит внутреннее имя списка.
StorageTZ	Задает способ хранения значения даты и времени. Когда для атрибута StorageTZ задано значение UTC, дата и время обрабатываются в формате UTC. Чтобы указать, что значения даты и времени "абстрактны", то есть хранятся в базе данных как введенные пользователем, без преобразования или хранения локального часового пояса, опустите атрибут StorageTZ.
StripwS	Необязательный логический. Имеет значение TRUE, если пробелы в начале и конце значений поля удаляются.
SuppressNameDisplay	Необязательный логический. При значении TRUE имя пользователя не отображается в поле User.
TextOnly	Необязательный логический. При значении TRUE поле может содержать только значения типа Text.
Title	Необязательный атрибут типа Text. Содержит заголовок поля, отображаемый в пользовательском интерфейсе.
Тип	Обязательный текст. Тип данных поля (если элемент Field не является дочерним для элемента ProjectedFields). ПРИМЕЧАНИЕ. В выпуске Technology Preview Microsoft SharePoint Foundation 2010 атрибут Type имеет другое значение и только одно возможное значение ("Уточняющий запрос"), если он является дочерним элементом ProjectedFields. Дополнительные сведения об использовании типа см. в разделе Элемент ProjectedFields (View). По умолчанию SharePoint Foundation включает следующие типы данных: - AllDayEvent Указывает событие в течение всего дня. Соответствует типу данных SQL bit. - Вложения Сохраняет URL-адреса для вложений. Соответствует типу данных SQL bit. - Логических Используется для хранения значения TRUE/ FALSE (хранится в базе данных как 0 или 1). Это поле поддерживает сортировку и группировку. Соответствует битовому типу данных SQL и представлен классом SPFieldBoolean . - Рассчитывается Указывает поле, значение которого вычисляется на основе других столбцов. Соответствует типу данных SQL sql_variant и представлен классом SPFieldCalculated . - Выбор Позволяет пользователю указать предопределенный набор значений, которые можно использовать для ввода данных в поле. Типы Choice и Lookup — поля, наиболее важные для сортировки и группировки. Атрибуты BaseType и Format могут использоваться для полей выбора. Это поле поддерживает сортировку и группировку. Если для параметра выбора задано значение, это значение используется в качестве переданного значения для выбора поля. Когда значение не задано, выбор отправляется как текстовое значение варианта. Во всех случаях текстовым значением варианта является отображаемое в пользовательском интерфейсе (текст в раскрывающемся списке или переключателе). Порядок отображения вариантов в пользовательском интерфейсе редактирования всегда соответствует порядку в элементе CHOICES. Используйте тип MultiChoice для указания поля Choice, которое реализует флажки и позволяет пользователю выбирать несколько значений. Соответствует типу данных SQL nvarchar и представлен классом SPFieldChoice . - Вычисляемый Указывает поле, которое зависит от другого поля для его содержимого. Например, поле LinkTitleNoMenu окружает значение поля заголовка гиперссылкой. Представлено классом SPFieldComputed . - ContentTypeId Содержит идентификатор типа контента. Дополнительные сведения о формате идентификаторов типов контента см. в статье Content Type IDs. Соответствует типу данных SQL varbinary. - Счетчик Обычно используется только для внутреннего поля идентификатора. Его целое значение задается автоматически как уникальное среди элементов текущего списка. Тип Counter всегда доступен только для чтения и не может быть задан через отправку формы. Это поле поддерживает сортировку, но не группировку. Соответствует типу данных SQL int. - CrossProjectLink Используется для подключения события в списке SharePoint к сайту рабочей области для собраний; относится, в частности, к типу поля флажка, используемого в формах "Создать" и "Изменить элемент" для создания сайта рабочей области собрания для элемента. Соответствует битовому типу данных SQL и представлен классом SPFieldCrossProjectLink . - Валюты Позволяет ввести значение валюты. Каждое поле валюты привязано к валюте определенного языкового стандарта. Во всех прочих отношениях оно обрабатывается как тип поля Number. Используйте атрибут LCID для указания валюты определенного языкового стандарта. Атрибуты Decimals, Max и Min могут использоваться для типов валюты. Это поле поддерживает сортировку и группировку. Соответствует типу данных SQL float и представлен классом SPFieldCurrency . - Datetime Позволяет хранить полную дату или время суток. Используйте атрибут Format для указания форматирования даты и атрибут StorageTZ для определения способа хранения значений даты и времени. Это поле поддерживает сортировку и группировку. Для режима отображения порядок форматирования даты извлекается из региональных параметров ("М/Д/Г" или "Д/М/Г"). В режиме редактирования (или режиме создания для значения элемента Default) значения даты и времени отображаются в международном формате: М/Д/Г чч:мм am/pm. Соответствует типу данных SQL datetime и представлен классом SPFieldDateTime . - Файл Содержит файл. Соответствует типу данных SQL uniqueidentifier. - GridChoice Содержит шкалу оценки для опросов. Соответствует типу данных ntext SQL и представлен классом SPFieldRatingScale . - Guid Позволяет использовать глобальные уникальные идентификаторы (GUID). Соответствует типу данных SQL uniqueidentifier. - Целое число Позволяет использовать положительные или отрицательные целочисленные значения. Атрибуты Commas и NegativeFormat используются для указания форматирования целых значений. Соответствует типу данных SQL int. - Поиска Поведение очень похоже на поле "Выбор ", за исключением того, что доступные параметры поступают из другого списка, а не из жестко запрограммированного выбора значений. Можно использовать атрибуты List и ShowField для полей подстановки. Это поле поддерживает сортировку и группировку. Для сортировки и группировки используйте значение DisplayField (по умолчанию — заголовок), а не внешний ключ, хранящийся в списке. Соответствует типу данных SQL int и представлен классом SPFieldLookup . - LookupMulti Поле подстановки , которое может содержать несколько значений. Родительский тип: Lookup. - ModStat Содержит состояние утверждения содержимого. Возможные значения: Approved (по умолчанию), Rejected и Pending (хранятся в базе данных как 0, 1 и 2 соответственно). Соответствует типу данных SQL int. - MultiChoice Задает поле "Выбор ", которое реализует флажки и позволяет пользователю выбирать несколько значений. Соответствует типу данных ntext SQL и представлен классом SPFieldMultiChoice . - MultiColumn Поле Заметка , эмулирующее поле, содержащее несколько значений. Пример типа поля с несколькими столбцами см. в статье Custom Field Type Definition. Сведения о полях с несколькими столбцами см. в разделе Пользовательские классы полей с несколькими столбцами. Родительский тип: Note. - Примечание Позволяет пользователям вводить несколько строк текста. Это поле не поддерживает сортировку и группировку. Весь текст определяется как символы ASCII без разметки HTML. Все похожее на разметку HTML или URL-адрес заключается в кавычки (например, Server.HTMLEncode) для придания вида обычного текста. Элемент управления для редактирования этого формата — простой блок TEXTAREA. Используйте атрибут NumLines для указания числа отображаемых строк. Соответствует типу данных SQL ntext и представлен классом SPFieldMultiLineText . - Номер Позволяет вводить число с плавающей запятой. Это поле поддерживает сортировку и группировку. Числа вводятся и анализируются в соответствии с параметрами текущего языкового стандарта для десятичного разделителя и разделителя групп разрядов. Отрицательные числа обозначаются посредством заключения в скобки или использования соответствующего символа. Можно использовать следующие атрибуты в сочетании с атрибутом Number для указания форматирования числа: Decimals, Div, Max, Min, Mult и Percentage. Соответствует типу данных SQL float и представлен классом SPFieldNumber . - PageSeparator Вставляет разрыв страницы в список опросов. Представлено классом SPFieldPageSeparator . - Повторения Используется для изменения и определения шаблона повторения для элемента в списке событий. Соответствует типу данных SQL bit. - Текст Одна строка текста, введенная в поле редактирования. Это поле поддерживает сортировку и группировку. Используйте атрибут MaxLength для задания максимально разрешенного числа символов. Соответствует типу данных SQL nvarchar и представлен классом SPFieldText . - ThreadIndex Содержит идентификатор, указывающий относительное положение сообщения в потоке беседы. Соответствует типу данных SQL varbinary. - Threading Тип поля Threading используется при создании и отображении потоковых представлений, похожих на обсуждение. Любой список может содержать столбец цепочки, но при его использовании создается особый пользовательский интерфейс. (Он никогда не отображается как стандартное редактируемое поле в форме или как обычный столбец в представлении.) Если сортировка выполняется в потоковом поле, возвращается предварительный обход всех записей в отношениях "родители-потомки". Это достигается с помощью сохранения объединенных даты создания и идентификатора всех родительских записей определенной записи. Соответствует типу данных SQL varchar. - URL Используется для создания гиперссылки в свободной форме. Поле URL-адреса отображается как `<A HREF="URL">Description</A>`. Если описание не указано, оно отображается как `<A HREF="URL">URL</A>`. Текст URL-адреса хранится в таблице URL-адресов (DocMd), в которой хранятся все URL-адреса в базах данных SharePoint на сервере. Благодаря этому любые URL-адреса, которые хранятся локально на сервере, могут обновляться посредством адресной привязки ссылки при изменении места назначения. При удалении записи, в которой содержится поле URL-адреса, соответствующая связанная запись из таблицы URL-адресов также удаляется. Для этого поля можно выполнять сортировку и группировку. (Сортировка определяется в соответствии с текстовым описанием, а не содержимым URL-адреса. Если описание не указано, она сортируется так же, как пустое.) Если Тип имеет значение URL-адрес, атрибут LinkType можно использовать для указания типа ссылки. Соответствует типу данных SQL nvarchar и представлен классом SPFieldUrl . - Пользователя Поле подстановки , ссылающееся на таблицу базы данных UserInfo. Соответствует типу данных SQL int и представлен классом SPFieldUser . - UserMulti Поле Пользователя , которое может содержать несколько значений. Родительский тип: LookupMulti. - WorkflowEventType Указывает тип события рабочего процесса, представленный перечислением SPWorkflowHistoryEventType . Родительский тип: Integer. - WorkflowStatus Указывает состояние рабочего процесса, представленное перечислением SPWorkflowStatus . Соответствует типу данных SQL nvarchar.
UniqueId	Необязательный атрибут типа Text. Не для использования непосредственно из кода.
UnlimitedLengthInDocumentLibrary	Необязательный логический. Значение TRUE разрешает неограниченную длину поля в библиотеках документов.
URLEncode	Необязательный логический. ЗНАЧЕНИЕ TRUE для преобразования специальных символов, таких как пробелы, в формат UTF-8 с кавычками, `%c3%ab` например для символа `ë`.
URLEncodeAsURL	Необязательный логический. Как URLEncode, но значение TRUE указывает, что кодируемая строка является компонентом пути URL-адреса, чтобы не кодировать косую черту (`/`).
UserSelectionMode	Необязательный атрибут типа Text. Указывает, возможен ли в поле пользователя в форме элемента выбор только имен отдельных пользователей или также допускается выбор групп. Возможны следующие значения: 0 (можно выбирать только имена отдельных пользователей). 1 (можно выбирать имена как отдельных пользователей, так и групп).
UserSelectionScope	Необязательный атрибут типа Integer. Указывает область для выбора имен пользователей в поле пользователя в форме элемента. При значении 0 выбор не ограничен группой SharePoint. Если значение больше 0, выбор пользователей ограничен членами группы SharePoint, идентификатор которой равен указанному значению.
Версия	Необязательный текст.
Просмотра	Необязательный логический. Значение TRUE указывает, что поле добавлено в представление по умолчанию. Значение по умолчанию — TRUE.
WebId	Необязательный текст.
Width	Необязательный атрибут типа Integer. Указывает ширину изображений, отображаемых для пользователей в списке сведений о пользователе, в пикселях.
Вики-ссылки	Необязательный логический. ЗНАЧЕНИЕ TRUE , чтобы указать, что вики-ссылки, которые отображаются в виде двойных скобок (`[[…]]`), преобразуются в HTML-ссылки, использующие `<A>` тег .
Xname	Необязательный атрибут типа Text. Используется для внутренних целей в XML-формах для обозначения полей, которые были добавлены, удалены или изменены. Этот атрибут не предназначен для общего использования.

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

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

Occurrences

Минимум: 0
Максимум: без ограничений, если родительским элементом является Fields. Если родительским элементом является ProjectedFields, максимальной является разница между максимальным числом разрешенных полей в запрашиваемом первичном списке и числом полей, которые уже находятся в списке.

Замечания

Чтобы создать настраиваемое определение поля для определения списка, основанного на типе поля SharePoint Foundation по умолчанию, используйте элемент Field (List — Definition) в файлеSchema.xml .

Чтобы создать пользовательское определение поля в качестве подключаемого компонента, основанного на типе поля по умолчанию и который можно повторно использовать на веб-сайтах и в списках в семействе веб-сайтов, используйте элемент Field (Field) для определения настраиваемого столбца сайта.

Чтобы создать тип настраиваемого поля, реализующий настраиваемый класс для специальной проверки данных и визуализации полей, следует использовать элемент Field (Field Types).

На поля могут ссылаться определения представления, а также выражения в элементах визуализации вычисленных полей. Чтобы возвращать значение форматированного поля для отображения в представлении, следует использовать элемент Field (View); чтобы возвращать значение исходных данных поля, следует использовать элемент Column (View).

Используется следующий синтаксис для ссылки на поле:

<Field Name="FieldName"/>

По умолчанию поле отображается с атрибутами по умолчанию для этого определения поля, как указано в предыдущей таблице. Любой из атрибутов поля можно переопределить в разметке CAML атрибута FieldRef , которая переопределяет определение, данное для самого поля (атрибут Type для поля нельзя изменить).

Для отображения пользовательского отображаемого имени поля можно использовать <Property Select="DisplayName"/>.

В перечислении элемента Fields можно исключить атрибут Name. Для некоторых ссылок на поля необработанные данные, хранящиеся для поля, можно получить с помощью <Column/>.

Некоторые свойства полей из форм и определенных аспектов пользовательского интерфейса разработки можно отрисовыть с помощью элемента Property , например или <Property Select="Description"/><Property Select="Type"/>. Данные элементы просто извлекают значение любого атрибута поля или дочернего элемента (Property) по имени.

В дополнение к предыдущим типам с элементом Field используются следующие предопределенные поля:

Имя	Описание
Created	Поле, которое содержит значение DateTime, определяющее время создания элемента (в формате UTC).
CreatedBy	Поле, которое содержит значение Lookup, относящееся к таблице "Данные_пользователя" и обозначающее пользователя, создавшего элемент.
Edit	Вычисленное поле (без дополнительной схемы), которое содержит гиперссылку на форму редактирования элемента. В целях идентификации элемента, данное поле ссылается на страницу изменения элемента и на поле идентификатора.
ID	Тип поля Counter, связанный с каждым элементом каждого списка. Идентификатор уникальным образом идентифицирует элемент списка в формах URL-адресов и POST при редактировании. Указание New в качестве значения атрибута ID в команде Cmd=Save создает элемент, а не изменяет текущий элемент.
Modified	Поле, которое содержит значение DateTime, указывающее время последнего изменения элемента (в формате UTC). Время Modified используется в некоторой степени также в качестве поля Version. Дата последнего изменения элемента всегда проставляется при изменении существующего элемента. Если эта дата не соответствует текущей дате изменения, серверу не удается выполнить изменение, и он возвращает ошибку, отображая также ссылку на текущую дату на сервере (открывается в новом окне), чтобы можно было скопировать значения из старой формы в новую.
ModifiedBy	Поле, которое содержит значение Lookup в таблице "Данные_пользователя", обозначающее пользователя, который последним редактировал элемент.
Title	Базовое отображаемое имя для каждого элемента. В различных списках могут содержаться различные отображаемые имена, однако внутреннее имя поля для Title остается неизменным. Заголовок по умолчанию отображается для полей Lookup в списках.
LinkTitle	Вычисленное поле, которое отображает гиперссылки на элементы, содержащие текст заголовка и создающие URL-адреса (и новые ярлыки) для элементов. Для данного поля не существует дополнительного хранилища; при визуализации своего пользовательского интерфейса оно полагается на поля "Заголовок" и "Идентификатор".

Примечание.

На поля, возвращаемые в перечислении Fields, влияет режим отображения. Поля, помеченные атрибутом Hidden, не возвращаются. Поля, помеченные атрибутом ReadOnly, не возвращаются в том случае, если выполняется визуализация формы (если Fields вызывается из элемента ListForm). Поля, помеченные атрибутом ShowInNewForm, не возвращаются при режимах отображения "NEW" или "PREVIEWNEW". Поля, помеченные атрибутом ShowInFileDlg, не возвращаются при выполнении визуализации формы диалогового окна NewForm.

Пример

В следующем примере элемент Field используется для указания параметров для списка с именем Area list:

<Field Type="Choice" BaseType="Text" Name="Area">
  <CHOICES>
    <CHOICE>Views</CHOICE>
    <CHOICE>Site Design</CHOICE>
    <CHOICE>Layouts</CHOICE>
    <CHOICE>Schema Design</CHOICE>
    <CHOICE>Fields</CHOICE>
    <CHOICE>Forms</CHOICE>
    <CHOICE>Projects</CHOICE>
    <CHOICE>Inter-Team Issues</CHOICE>
    <CHOICE>Schedule</CHOICE>
    <CHOICE>Spec</CHOICE>
    <CHOICE>Headcount</CHOICE>
    <CHOICE>Misc</CHOICE>
  </CHOICES>
</Field>

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