Элемент Field (Field)

Статья
04/08/2023

Область применения: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Определяет столбец сайта.

Определение

<Field
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  AllowDeletion="TRUE" | "FALSE"
  AllowDuplicateValues="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"
  Commas="TRUE" | "FALSE"
  Customization=Text
  Decimals="Integer"
  DefaultListField="TRUE" | "FALSE"
  Description="Text"
  Dir="Text"
  DisplaceOnUpgrade="TRUE" | "FALSE"
  DisplayImage="Text"
  DisplayName="Text"
  DisplayNameSrcField="Text"
  DisplaySize=Integer
  Div="Number"
  EnableLookup="TRUE" | "FALSE"
  ExceptionImage="Text"
  FieldRef="Text"
  FillInChoice="TRUE" | "FALSE"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  ForcedDisplay="Text"
  Format="DateOnly | DateTime | TimeOnly | EventList | ISO8601 | MonthDayOnly | MonthYearOnly | ISO8601Basic | ISO8601Gregorian | ISO8601BasicDateOnly | DropDown | RadioButtons | HyperLink | Image | TRUE | FALSE"
  FromBaseType="TRUE" | "FALSE"
  Group="Text"
  HeaderImage="Text"
  Height="Integer"
  Hidden="TRUE" | "FALSE"
  HTMLEncode="TRUE" | "FALSE"
  ID="Text"
  IMEMode="active | 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"
  List="Text"
  Max="Number"
  MaxLength="Integer"
  Min="Number"
  Mult="TRUE" | "FALSE"
  Name="Text"
  NegativeFormat="MinusSign" | "Parens"
  Node="Text"
  NoEditFormBreak="TRUE" | "FALSE"
  NumLines="Integer"
  Overwrite="TRUE" | "FALSE"
  OverwriteInChildScopes="TRUE" | "FALSE"
  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="Restrict | Cascade | None"
  RenderXMLUsingPattern="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  RestrictedMode="TRUE" | "FALSE"
  ResultType="Text"
  RichText="TRUE" | "FALSE"
  RichTextMode="Text"
  RowOrdinal="Integer"
  Sealed="TRUE" | "FALSE"
  SeperateLine="TRUE" | "FALSE"
  SetAs="Text"
  ShowAddressBookButton="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"
  Viewable="TRUE" | "FALSE"
  Width="Integer"
  WikiLinking="TRUE" | "FALSE"
  XName="Text">
</Field>

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

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

Атрибуты

Атрибут	Описание
Агрегации	Необязательный атрибут типа Text. Используется в агрегатном поле XML-формы для указания функции, применяемой к коллекции значений или элементов, возвращенных выражением XPath. Если используется атрибут Node для указания выражения XPath, возвращающего коллекцию значений, можно также включить атрибут Aggregation, указывающий действие для выполнения над возвращенным набором значений. Этим действием может быть агрегатная функция или указатель определенного элемента в коллекции. Возможны следующие значения: sum: добавьте значения. count: подсчитайте количество значений. average: найдите среднее значение значений. min: найдите минимальное значение. max: найдите максимальное значение. merge: слияние значений. plaintext: преобразует текстовое содержимое узла в обычный текст. first: примените повышение и понижение свойств к первому элементу в коллекции. last: примените повышение и понижение свойств к последнему элементу в коллекции. Дополнительные сведения о том, как атрибуты Node, PIAttribute, PITarget, PrimaryPIAttribute и PrimaryPITarget используются для повышения и понижения свойств в XML-документах, см. в разделе Использование типов контента для указания свойств XML-документа.
AllowDeletion	Необязательный логический. Имеет значение TRUE, если поле может быть удалено.
AllowDuplicateValues	Необязательный логический. Указывает, разрешены ли повторяющиеся значения в данном поле списка. Значение false, запрещающее ввод повторяющихся значений, фактически задает для поля поведение первичного ключа. Если в поле разрешено дублирование значений, атрибут имеет значение True, а если нет — false. Значение по умолчанию 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.
Запятыми	Необязательный логический. Имеет значение TRUE, если для разделения разрядов тысяч используются запятые.
Настройка	Необязательный атрибут типа Text. Предоставляет возможность добавления настраиваемых свойств в настраиваемые типы полей.
Десятичные дроби	Необязательный атрибут типа Integer. Обозначает количество десятичных знаков для отображения. Отображаемое значение округляется в большую сторону; например, 1,05 при округлении до одного десятичного знака отображается как 1,1.
DefaultListField	Необязательный логический. Получает значение, задающее режим отображения формы Изменить свойства для файла при отправке файла в библиотеку документов. Если добавляемое в библиотеку поле не имеет видимой формы Изменить свойства, атрибут принимает значение True, в ином случае — false. Значение по умолчанию: false.
Описание	Необязательный атрибут типа Text. Предоставляет описание, отображаемое в форме редактирования для списка, если указано описание поля. По умолчанию поля в Microsoft SharePoint Foundation не имеют описаний.
Dir	Необязательный атрибут типа Text. Указывает направление текста для поля, поддерживающего двунаправленный порядок чтения. Возможные значения: LTR (слева направо), RTL (справа налево) и none.
DisplaceOnUpgrade	Необязательный логический. Если для поля уже существует определение, значение TRUE задает обновление свойств поля с использованием значений, указанных в этом определении поля.
DisplayImage	Необязательный атрибут типа Text. Указывает имя значка, отображаемого для столбца.
DisplayName	Необязательный атрибут типа Text. Отображаемое имя поля. Ограничение на использование пробелов отсутствует. Максимальная длина: 255 символов. Значение может быть ссылкой на ресурс в формате $Resources:String. Дополнительные сведения см. в статье Локализация решений SharePoint. Пользователь может изменить отображаемое имя, оно также может изменяться после первоначального создания поля. Это имя используется как заголовок столбца при отображении поля в представлении таблицы и как метка формы при отображении поля в форме.
DisplayNameSrcField	Необязательный атрибут типа Text. Обычно используется для вычисляемого поля, которому необходимо такое же имя, как и у другого поля. Если изменяется исходное поле и пользователь изменяет отображаемое имя, имя этого поля также редактируется. Эта строка ссылается на имя другого поля.
DisplaySize	Необязательное целое число.
Div	Необязательный атрибут типа Number. Коэффициент масштабирования, используемый при делении перед отображением числа. Отображаемое число — N * Mult / Div (округляется до числа, указанного атрибутом Decimals).
EnableLookup	Необязательный логический. Значение TRUE разрешает использование значений подстановки в поле.
ExceptionImage	Необязательный текст. Используется в типе поля Recurrence для указания имени файла изображения, используемого для исключений.
FieldRef	Необязательный атрибут типа Text. Для вторичного поля подстановки указывает идентификатор первичного поля подстановки, от которого оно зависит. Значение должно быть строковым представлением GUID без фигурных скобок.
FillInChoice	Необязательный логический. Имеет значениеTRUE, если поле допускает заполнение пользователями значений для столбца.
Filterable	Необязательный логический. Имеет значение TRUE, если разрешена фильтрация поля.
FilterableNoRecurrence	Необязательный логический. Имеет значение TRUE, если может быть создан фильтр для поля в представлении без развертывания повторяющихся событий. Если атрибут Filterable содержит значение TRUE, фильтрация поля возможна во всех представлениях, независимо от значения атрибута FilterableNoRecurrence.
ForcedDisplay	Необязательный атрибут типа Text. Указывает текст для отображения вместо фактического значения поля. Этот атрибут используется в опросах для предотвращения отображения имени пользователя.
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	Обязательный атрибут типа Text. Однозначно определяет поле. Значение должно быть строковым представлением GUID, содержащегося в фигурных скобках ({}).
IMEMode	Необязательный атрибут типа Text. Задает смещение режима IME для использования в поле. Редактор метода ввода позволяет использовать одни и те же клавиши при работе с несколькими языками, когда одна система письма имеет больше символов, чем может быть закодировано для данной клавиатуры. Возможны следующие значения: auto: не используется. Чтобы указать этот режим IME, задайте в качестве значения свойства IMEMode пустую строку (""). активный: все символы вводятся с помощью IME, но пользователи по-прежнему могут деактивировать IME. неактивно: символы вводятся без IME, хотя пользователи по-прежнему могут активировать IME.
Indexed	Необязательный логический. Имеет значение TRUE, если столбец индексирован для использования в фильтрах представления. Примечание. Хотя для повышения производительности можно индексировать столбец подстановки, использование индексированного столбца подстановки для предотвращения превышения порогового значения представления списка не работает. Чтобы избежать превышения порогового значения представления списка, используйте столбец другого типа в качестве первичного или вторичного индекса.
IsolateStyles	Необязательный логический. Для поля Text, атрибут RichText которого имеет значение TRUE, а атрибут RichTextMode — значение FullHtml, этот атрибут указывает, что сервер будет перезаписывать HTML данного поля, чтобы исключить помехи при отрисовке окружающей страницы.
IsRelationship	Необязательный логический. Значение TRUE , если это поле возвращается методом GetRelatedFields() из другого списка.
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.
List	Необязательный текст. Используется, чтобы задать целевой список для поля подстановки (Type="Lookup"). Если целевой список уже существует, значением атрибута List должно быть строковое представление GUID (включая фигурные скобки) целевого списка. Если целью является тот же список, к которому принадлежит поле, можно указать "Self". Если целевой список еще не существует, значением атрибута List может быть указанный относительно веб-сайта URL-адрес, такой как "Lists/My List", но только при создании целевого списка в той же функции, в которой создано поле подстановки. В этом случае значение атрибута List в элементе Field должно совпадать со значением атрибута Url в элементе ListInstance, создающем целевой список.
Max	Необязательный атрибут типа Number. Указывает максимально допустимое значение поля.
MaxLength	Необязательный атрибут типа Integer. Задает максимальное число знаков, допустимое в значении поля. Формы редактирования приводятся в соответствие с этим значением, которое проверяется в клиентском приложении. При попытке ввести больше знаков, чем задано в параметре MaxLength, отображается сообщение об ошибке.
Min	Необязательный атрибут типа Number. Указывает минимальное допустимое значение поля.
Мульт	Необязательный логический. Значение TRUE разрешает использование множественных значений в поле подстановки. Значение по умолчанию — FALSE.
Имя	Обязательный текст. Инициализирует новый экземпляр SP.CamlQuery object (sp.js). Имя должно быть уникальным по отношению к набору полей в списке или на веб-сайте. SharePoint Foundation изменит значение при необходимости, чтобы гарантировать его уникальность; в противном случае он не изменяется в течение времени существования определения поля.
Отрицательный формат	Необязательный атрибут типа Text. Указывает способ обозначения отрицательных значений. Может иметь одно из следующих значений: МинусЗначение: используйте знак "минус" в качестве префикса. Parens: окружите круглыми скобками.
Node	Необязательный текст. Этот атрибут, используемый в XML-формах, является обязательным для всех полей, кроме ссылок инструкций обработки (PI), и указывает выражение XPath для узла, который повышен.
NoEditFormBreak	Необязательный логический. Значение TRUE запрещает добавление разрывов строк между полями в формах создания или изменения элементов. Некоторые типы полей, такие как поля форматированного текста, задают интервалы по умолчанию, а этот атрибут позволяет контролировать получающиеся дополнительные интервалы.
NumLines	Необязательный атрибут типа Integer. Рекомендует число строк для отображения в блоке TEXTAREA при редактировании. Это просто подсказка в клиентском пользовательском интерфейсе — никакого ограничения по числу строк редактируемого текста не существует.
Overwrite	Необязательный логический. Указывает, перезаписывает ли определение нового поля, активированное на сайте (SPWeb), определение существующего поля в случаях, когда новое поле имеет такой же идентификатор, как и существующее поле. Если новое поле перезаписывает существующее поле с тем же идентификатором, имеет значение True, если нет — false. Значение по умолчанию: false. Примечание. Если существующее поле доступно только для чтения или запечатано, оно не будет перезаписано активируемым полем, даже если для этого атрибута задано значение true.
OverwriteInChildScopes	Необязательный логический. Указывает, следует ли при подготовке поля в семействе веб-сайтов перезаписать указанное определение поля, уже существующее в дочернем веб-сайте этого семейства. Если определение поля следует перезаписать, имеет значение True, если нет — false. Значение по умолчанию — false.
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	Необязательный атрибут типа Text. Задает ограничение удаления для поля подстановки. Дополнительные сведения см. в перечислении SPRelationshipDeleteBehavior . Для столбца сайта этот атрибут не должен иметь значение Cascade или Restrict. Допускается значение None (по умолчанию), можно также опустить этот атрибут. При указании любого значения, отличного от None, необходимо также задать значение TRUE для атрибута Indexed и значение FALSE для атрибута Mult.
RenderXMLUsingPattern	Необязательный логический. Используется в случае вычисляемых полей для определения формата отображения. При значении TRUE значения отображаются на основе шаблона вычисляемого поля, а не значения столбца ссылки на первое невычисляемое поле, на котором основано вычисляемое поле. Например, в библиотеке изображений столбец "Размер изображения" представлен значениями ширина x высота, но если для этого атрибута не задано значение TRUE, отображается только ссылка на первое поле, ширина. Если задано значение TRUE, отображается формат ширина x высота.
Required	Обязательный атрибут типа Boolean. При значении TRUE поле не должно иметь назначенных ему пустых значений. Если значение поля nonempty не задано в записи формы, в форме ошибки отображается либо стандартный текст обязательного поля, либо явно указанное сообщение (т. е. с помощью `<ErrorText>` тегов). Эту проверку выполняет только клиент (база данных всегда допускает значения NULL для всех пользовательских полей).
RestrictedMode	Необязательный логический. Значение TRUE запрещает использование в поле Note расширенного форматирования текста, такого как изображения, таблицы или гиперссылки, а также запрещает вставку форматированного текста в это поле.
ResultType	Необязательный атрибут типа Text. Указывает типы данных значений, возвращаемых из поля.
RichText	Необязательный логический. Имеет значение TRUE, если поле отображает форматирование текста.
RichTextMode	Необязательный текст. Один из параметров перечисления RichTextMode.
RowOrdinal	Необязательный атрибут типа Integer. Указывает расположение базы данных для поля.
Запечатаны	Необязательный логический. Установка значения TRUE помечает соответствующее поле как неудаляемое. На странице Изменение столбца отсутствует кнопка Удалить. Пользователи не могут удалить это поле.
SeparateLine	Необязательный логический. Используется внутренне для поддержки отрисовки поля (например, "Заметки" или "Примечания") в отдельной строке. Этот атрибут не предназначен для общего использования.
SetAs	Не для использования непосредственно из кода.
ShowAddressBookButton	Не для использования непосредственно из кода.
ShowField	Необязательный текст. Когда атрибут Type имеет значение "Lookup", значение атрибута ShowField указывает внутреннее имя целевого поля для подстановки. Если значение не указано, отображается указанный в гиперссылкой текст из поля заголовка записи в целевом списке. В качестве цели поля подстановки разрешены следующие типы полей: Counter, DateTime, Number и Text. Тип поля Computed может быть целью, если подстановки включены. Дополнительные сведения см. в разделе Свойство EnableLookup класса SPFieldComputed . Тип поля Calculated может быть целью, если выходные данные — это текст. Дополнительные сведения см. в свойстве OutputType класса SPFieldCalculated**.
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. Содержит внутреннее имя поля, которое может не быть уникальным в коллекции полей. Однако в отличие от атрибута Name, который может быть исправлен для обеспечения его уникальности, значение атрибута StaticName присваивается полю в точности как определено. Позже это значение можно использовать в коде, чтобы получить ссылку на поле, вызвав метод TryGetFieldByStaticName .
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 . Currency: позволяет вводить значение валюты. Каждое поле валюты привязано к валюте определенного языкового стандарта. Во всех прочих отношениях оно обрабатывается как тип поля 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. Integer: позволяет использовать положительные или отрицательные целые значения. Атрибуты 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. Сведения о полях с несколькими столбцами см. в статье Custom Multicolumn Field Classes. Родительский тип: Note. Примечание. Позволяет пользователям вводить несколько строк текста. Это поле не поддерживает сортировку и группировку. Весь текст определяется как символы ASCII без разметки HTML. Все похожее на разметку HTML или URL-адрес заключается в кавычки (например, Server.HTMLEncode) для придания вида обычного текста. Элемент управления для редактирования этого формата — простой блок TEXTAREA. Используйте атрибут NumLines для указания числа отображаемых строк. Соответствует типу данных SQL ntext и представлен классом SPFieldMultiLineText . Number: позволяет вводить число с плавающей запятой. Это поле поддерживает сортировку и группировку. Числа вводятся и анализируются в соответствии с параметрами текущего языкового стандарта для десятичного разделителя и разделителя групп разрядов. Отрицательные числа обозначаются посредством заключения в скобки или использования соответствующего символа. Можно использовать следующие атрибуты в сочетании с атрибутом Number для указания форматирования числа: Decimals, Div, Max, Min, Mult и Percentage. Соответствует типу данных SQL float и представлен классом SPFieldNumber . PageSeparator: вставляет разрыв страницы в список опросов. Представлено классом SPFieldPageSeparator . Повторение: используется для изменения и определения шаблона повторения для элемента в списке событий. Соответствует типу данных SQL bit. Текст: одна строка текста, введенная в поле редактирования. Это поле поддерживает сортировку и группировку. Используйте атрибут MaxLength для задания максимально разрешенного числа символов. Соответствует типу данных SQL nvarchar и представлен классом SPFieldText . ThreadIndex: содержит идентификатор, указывающий относительное положение сообщения в потоке беседы. Соответствует типу данных SQL varbinary. Потоки. Тип поля Threading используется при создании и отображении потоковых представлений, похожих на обсуждение. Любой список может содержать столбец цепочки, но при его использовании создается особый пользовательский интерфейс. (Он никогда не отображается как стандартное редактируемое поле в форме или как обычный столбец в представлении.) Если сортировка выполняется в потоковом поле, возвращается предварительный обход всех записей в отношениях "родители-потомки". Это достигается с помощью сохранения объединенных даты создания и идентификатора всех родительских записей определенной записи. Соответствует типу данных SQL varchar. URL-адрес: используется для создания гиперссылки в свободной форме. Поле URL-адреса отображается как Описание. Если описание не указано, оно отображается в виде URL-адреса. Текст 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.
Width	Необязательный атрибут типа Integer. Указывает ширину изображений, отображаемых для пользователей в списке сведений о пользователе, в пикселях.
Вики-ссылки	Необязательный логический. ЗНАЧЕНИЕ TRUE , чтобы указать, что вики-ссылки, которые отображаются в виде двойных скобок ([...]]), преобразуются в HTML-ссылки, использующие `<a>` тег .
Xname	Необязательный атрибут типа Text. Используется для внутренних целей в XML-формах для обозначения полей, которые были добавлены, удалены или изменены. Этот атрибут не предназначен для общего использования.

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

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

Элементы

Замечания

Важно!

При определении настраиваемого поля необходимо указать атрибуты ID, Type, Name, DisplayName и Group, чтобы поле отображалось правильно в Microsoft SharePoint Foundation. Завершение инструкции в Microsoft Visual Studio ошибочно указывает на то, что требуются только первые три этих атрибута, если на самом деле требуются все пять.

Пример

Следующий пример демонстрирует манифест элемента для функции, создающей три столбца сайта.

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="http://schemas.microsoft.com/sharepoint/">
  <Field ID="{060E50AC-E9C1-4D3C-B1F9-DE0BCAC300F6}"
          Name="Amount"
          DisplayName="Amount"
          Type="Currency"
          Decimals="2"
          Min="0"
          Required="FALSE"
          Group="Financial Columns" />

  <Field ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}"
          Name="CostCenter"
          DisplayName="Cost Center"
          Type="Choice"
          Required="FALSE"
          Group="Financial Columns">
    <CHOICES>
      <CHOICE>Administration</CHOICE>
      <CHOICE>Information</CHOICE>
      <CHOICE>Facilities</CHOICE>
      <CHOICE>Operations</CHOICE>
      <CHOICE>Sales</CHOICE>
      <CHOICE>Marketing</CHOICE>
    </CHOICES>
  </Field>

  <Field ID="{1511BF28-A787-4061-B2E1-71F64CC93FD5}"
          Name="DateOpened"
          DisplayName="Date Opened"
          Type="DateTime"
          Format="DateOnly"
          Required="FALSE"
          Group="Financial Columns">
    <Default>[today]</Default>
  </Field>
</Elements>

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