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


Элемент Field (List)

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

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

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

Определяет типы внутренних данных, используемые в инфраструктуре списка веб-сайта 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>

Атрибуты

Атрибут

Описание

Aggregation

Необязательный атрибут типа Text. Используется в агрегатном поле на XML-форме, чтобы указать функцию для применения к коллекции значений или элементам, возвращаемым выражением XPath. Если атрибут Node указывает выражение XPath, которое возвращает коллекцию значений, можно также включить атрибут Aggregation, который указывает, какое действие должно быть применено к набору возвращаемых значений — агрегирующая функция или обозначение конкретного элемента в коллекции.

Возможны следующие значения:

  • sum   Добавить значения.

  • count   Подсчитать количество значений.

  • average   Вычислить среднее значение.

  • min   Вычислить минимальное значение.

  • max   Вычислить максимальное значение.

  • merge   Выполнить слияние значений.

  • plaintext   Преобразует текстовый контент узла в обычный текст.

  • first   Применить увеличение или уменьшение значения свойства к первому элементу коллекции.

  • last   Применить увеличение или уменьшение значения свойства к последнему элементу коллекции.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, PrimaryPIAttribute и PrimaryPITarget для увеличения или уменьшения значений свойств в XML-документах см. в разделе Использование типов контента для задания свойств документа XML.

AllowDeletion

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

AllowHyperlink

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

AllowMultiVote

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

AppendOnly

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

AuthoringInfo

Необязательный атрибут типа Text. Строка описания, которая отображается на странице редактирования полей для идентификации поля и его задач; например, поле LinkTitle содержит сведения о разработке "(ссылка на элемент)". Данный атрибут, как правило, используется в случае, если существующее поле с тем же именем служит для других целей.

BaseType

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

CalType

Необязательный атрибут типа Integer. Обозначает тип календаря. Возможны следующие значения:

  • 16   Эра Сака (индийский)

  • 15   Китайский лунный

  • 14   Корейский и японский лунный

  • 12   Григорианский (транслитерированный французский)

  • 11   Григорианский (транслитерированный английский)

  • 10   Григорианский (арабский)

  • 9   Григорианский (ближневосточный французский)

  • 8   Иврит (лунный)

  • 7   Тайский

  • 6   Хиджра (лунный арабский)

  • 5   Корейский (эра Тангун)

  • 4   Тайваньский

  • 3   Японский (Мэйдзи)

  • 1   Григорианский

  • 0   Тип не указан

CanToggleHidden

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

ClassInfo

Необязательный атрибут типа Text. Обозначает класс таблицы каскадных стилей (CSS), который следует использовать для поля в стандартном просмотре таблицы. В случае выбора этого класса он используется вместо стандартного класса ms-vb2.

ColName

Необязательный атрибут типа Text. Внутренний атрибут, определяющий сопоставление поля с физическим именем хранилища для данного поля. Атрибут должен представлять собой допустимое имя в основной базе данных, которое совпадает с именем, используемым в таблице базы данных. Если имя не задано, сервер создаст имя столбца, которое не конфликтует с существующими именами столбцов и содержит только разрешенные сервером Microsoft SQL символы.

ColName2

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

Commas

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

Customization

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

Decimals

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

Description

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

Dir

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

Direction

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

DisplaceOnUpgrade

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

DisplayImage

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

DisplayName

Необязательный атрибут типа Text. Отображаемое имя поля. Ограничений для размера текста или использования пробелов нет. Отображаемое имя может изменяться пользователем; его можно изменить после изначального создания поля. Данное имя при отображении в просмотре таблицы используется как заголовок столбца, а при отображении поля в форме — как метка формы. Тег "<FieldName/>" возвращает отображаемое имя (если задано); в противном случае тег принимает значение по умолчанию атрибута Name.

DisplayNameSrcField

Необязательный атрибут типа Text. В основном используется для вычисленного поля, для которого требуется такое же имя, как и для другого поля. Если исходное поле редактировалось и отображаемое имя изменено пользователем, в таком случае имя данного поля также будет изменено. Эта строка ссылается на имя другого поля.

DisplaySize

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

Div

Необязательный атрибут типа Number. Масштабный коэффициент, используемый при делении перед отображением числа. Отображаемое число равно "N * Умн / Дел" (округляется до числа, как задано с помощью Decimals).

EnableLookup

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

EnforceUniqueValues

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

ExceptionImage

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

FieldRef

Необязательный атрибут типа Text. Обозначает имя другого поля, на которое ссылается поле; например, поле "Поиск".

FillInChoice

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

Filterable

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

FilterableNoRecurrence

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

ForcedDisplay

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

ForcePromoteDemote

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

Format

Необязательный атрибут типа Text. Обозначает тип форматирования числовых значений.

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

  • DateOnly   Отобразить (и разрешить изменять) только дату (для всех изменяемых значений время установлено как "12:00 A.M.").

  • DateTime   Отображение и изменение даты и времени (по умолчанию).

  • ISO8601   Отображает дату и время в формате времени ISO8601, преобразованном в формат единого времени (UTC): ГГГГ-ММ-ДДЧЧ:MM:СС. Этот формат используется для свойств документа в 2007 системы Microsoft Office, а также для стандартного формата обмена, используемого в SharePoint Foundation между формами New и Edit и сервером.

  • ISO8601Basic   Использование сокращенной формы даты и времени стандарта 8601: ГГГГММДДЧЧММСС. Этот формат используется для vCard/iCal.

Для полей выбора данному атрибуту может быть присвоено значение Dropdown (по умолчанию), которое предоставляет возможности редактирования с помощью выпадающего меню; или значение RadioButtons, обеспечивающее возможность редактирования посредством переключателей.

Для полей URL-адресов данному атрибуту может быть присвоено значение Hyperlink (по умолчанию), которое отображает URL-адрес в виде обычного тега "<A>"; или значение Image, отображающее URL-адрес как <IMG SRC="URL" ALT="Description">.

FromBaseType

Необязательный атрибут типа Boolean. Данный атрибут исключен; вместо него используется атрибут Sealed.

Group

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

HeaderImage

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

Height

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

Hidden

Необязательный атрибут типа Boolean. Если используется значение TRUE, поле в пользовательском интерфейсе полностью скрыто. Если свойству ReadOnly присвоено значение TRUE, поле не отображается в формах "Создать" и "Редактировать", но может включаться в представления.

HTMLEncode

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

ID

Необязательный атрибут типа Text. Обозначает глобальный уникальный идентификатор (GUID) поля, заключенный в фигурные скобки ({}).

Id

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

IMEMode

Необязательный атрибут типа Text. Указывает выбор режима редактора метода ввода (IME) для использования в поле. С помощью IME можно выполнять ввод символов языка, которые отсутствуют на данной клавиатуре.

Возможны следующие значения:

  • auto   Не используется. Чтобы указать режим IME, следует присвоить свойству IMEMode значение в виде пустой строки ("").

  • active   Все символы вводятся посредством IME, однако пользователи имеют возможность отключить IME.

  • inactive   Символы вводятся без помощи IME, хотя пользователи могут включить IME.

Indexed

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

IsolateStyles

Необязательный атрибут типа Boolean. Для поля Text, атрибут RichText которого имеет значение TRUE, а атрибут RichTextMode — значение FullHtml, данный атрибут определяет перезапись сервером HTML-кода поля, чтобы он не препятствовал визуализации остальной страницы.

IsRelationship

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

JoinColName

Необязательный атрибут типа Text. Данный атрибут определяется только для полей поиска. Он во многом похож на атрибут ColName, за исключением того, что обозначает имя столбца, который используется в SQL JOIN между локальным и внешним списками. Как правило, данное значение не следует изменять. В настоящее время оно используется только в схеме "Поле" определенных встроенных и базовых типовых полей для обозначения операций поиска по таблице URL-адресов (DocMd), внедренной в столбец UrlID.

JoinRowOrdinal

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

JoinType

Необязательный атрибут типа Text. Указывает тип JOIN, используемый для поля. Возможны следующие значения: INNER, LEFTOUTER и RIGHTOUTER.

LCID

Необязательный атрибут типа Integer. Атрибут LCID может использоваться для указания страны/региона, к которым относится используемый формат валюты — например, 1033 для США.

В двух случаях используется знак "евро". Если LCID = -1 (0xFFFFFFF), символ "евро" добавляется в качестве префикса к числу. Если LCID = -2 (0xFFFFFFE), знак "евро" добавляется к числу в качестве суффикса. Количество десятичных знаков — 2, хотя это может быть переопределено атрибутом Decimals поля. Символ валюты "евро" равнозначен 0x20AC в UCS-2.

LinkToItem

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

LinkToItemAllowed

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

List

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

ListItemMenu

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

ListItemMenuAllowed

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

Max

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

MaxLength

Необязательный атрибут типа Integer. Указывает максимальное количество символов, допустимое в значении поля. Формы редактирования настроены для принудительного использования данного значения, проверка которого выполняется на клиенте. Если пользователь пытается ввести символов больше, чем это задано атрибутом MaxLength, выводится сообщение об ошибке.

Min

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

Mult

Необязательный атрибут типа Boolean. Масштабный коэффициент, используемый при умножении до отображения числа.

Name

Обязательный атрибут типа Text. Имя поля. Это внутреннее имя поля, которое не подлежит каким-либо изменениям в ходе жизненного цикла определения поля. Имя должно быть уникальным в наборе полей в списке. Имя создается автоматически на основе имени поля, заданного пользователем.

NegativeFormat

Необязательный атрибут типа Text. Определяет способ индикации отрицательных значений. Может принимать одно из следующих значений:

  • MinusSign   Использовать знак минуса в качестве префикса.

  • Parens   Заключить в круглые скобки.

Node

Необязательный атрибут типа Text. Данный атрибут, используемый в XML-формах, обязателен для всех полей, за исключением ссылок на инструкции по обработке (PI). Атрибут определяет выражение XPath для активируемого сайта.

NoEditFormBreak

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

NumLines

Необязательный атрибут типа Integer. Предоставляет рекомендации в отношении количества строк (рядов) для отображения в блоке "TEXTAREA" во время правки. Это просто рекомендация клиентского пользовательского интерфейса — количество текстовых строк для редактирования не ограничено.

Percentage

Необязательный атрибут типа Boolean. Значение TRUE используется, если значение отображается в процентных долях; то есть в виде числа, умноженного на 100 с добавленным знаком процента (%).

PIAttribute

Необязательный атрибут типа Text. Определяет атрибут в инструкции по обработке документа (определяется атрибутом PITarget) для использования в качестве значения столбца. Используется для включения и отключения свойства в документах XML. Если задан атрибут PIAttribute, необходимо также задать атрибут PITarget.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для включения и отключения свойств в XML-документах см. в разделе Использование типов контента для задания свойств документа XML.

PITarget

Необязательный атрибут типа Text. Определяет инструкцию по обработке документа, в которой хранится значение столбца в документах с таким типом контента. Используется для включения и отключения свойства в документах XML. Если задан атрибут PIAttribute, необходимо также задать атрибут PITarget.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для включения и отключения свойств в XML-документах см. в разделе Использование типов контента для задания свойств документа XML.

PrependId

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

Presence

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

PrimaryKey

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

PrimaryPIAttribute

Необязательный атрибут типа Text. Используется для включения и отключения свойства в документах XML. Определяет переменную в инструкции по обработке документа, определяемую атрибутом PrimaryPITarget, для использования в качестве значения столбца. Если задан атрибут PrimaryPIAttribute, необходимо также задать атрибут PrimaryPITarget. В этом случае SharePoint Foundation использует данные значения до того, как они заданы атрибутами PITarget и PIAttribute.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для включения и отключения свойств в XML-документах см. в разделе Использование типов контента для задания свойств документа XML.

PrimaryPITarget

Необязательный атрибут типа Text. Определяет инструкцию по обработке документа, в которой хранится значение столбца в документах с таким типом контента. Если задан атрибут PrimaryPIAttribute, следует также задать атрибут PrimaryPITarget. В этом случае SharePoint Foundation использует данные значения до того, как они заданы атрибутами PITarget и PIAttribute.

Дополнительные сведения об использовании атрибутов Node, PIAttribute, PITarget, Primary PIAttribute и PrimaryPITarget для включения и отключения свойств в XML-документах см. в разделе Использование типов контента для задания свойств документа XML.

ReadOnly

Необязательный атрибут типа Boolean. Если используется значениеTRUE, поле не отображается в формах "Создать" или "Редактировать", но его можно включать в представления. Кроме того, если присвоить атрибуту ReadOnly значение TRUE, поле на странице "Настройки сайта" будет скрыто для управления столбцами и типами контента сайта.Если атрибуту Hidden присвоено значение TRUE, поле будет полностью скрыто в пользовательском интерфейсе. Если данный атрибут не задан, SharePoint Foundation обрабатывает столбец так, как если бы данный атрибут имел значение False.

ReadOnlyEnforced

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

RelationshipDeleteBehavior

Необязательный атрибут типа Text. Задает поведение поля при удалении. К возможным значениям относятся Cascade, Restrict и None.

RenderXMLUsingPattern

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

Required

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

RestrictedMode

Необязательный атрибут типа Boolean. Значение TRUE используется, чтобы запретить отображение расширенного текстового форматирования в поле Note (например, изображений, таблиц или гиперссылок), а также вставку в поле форматированного текста.

ResultType

Необязательный атрибут типа Text. Определяет тип данных значений, возвращаемых из поля.

RichText

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

RowOrdinal

Необязательный атрибут типа Integer. Определяет место размещения базы данных для поля.

Sealed

Необязательный атрибут типа Boolean. Если данному атрибуту присваивается значение TRUE для поля в файле Schema.xml для списка, поле помечается на странице "Изменить столбец" как неудаляемое.

SeparateLine

Необязательный атрибут типа Boolean. Используется внутренней памятью для поддержки визуализации поля (например, "Примечание" или "Комментарий") в отдельной строке. Данный атрибут не предназначен для общего пользования.

SetAs

Не рекомендуется использовать непосредственно из кода.

ShowAddressBookButton

Не рекомендуется использовать непосредственно из кода.

ShowAlways

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

ShowField

Необязательный. Для атрибута ShowField можно задать отображение имени поля. По умолчанию отображается текст гиперссылки из поля "Заголовок" записи во внешнем списке. Однако атрибут ShowField можно использовать, чтобы переопределить это значение для отображения другого поля из внешнего списка. В качестве целевых типов данных для атрибута ShowField допустимы следующие: Text, Choice и Counter. Для поля Lookup можно настроить данный параметр как внутреннее имя поля; если настроить его как отображаемое имя, это не приведет к ошибке, но целостность поля будет нарушена.

ShowInDisplayForm

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

ShowInEditForm

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

ShowInFileDlg

Необязательный атрибут типа Boolean. Данный атрибут допустим только для полей в схемах библиотеки документов. Если используется значение FALSE, поле не отображается в диалоговом окне свойств при сохранении форм, которое отображается при сохранении из клиентских приложений. Например, в поле "Заголовок" этот атрибут присутствует, поскольку он задан непосредственно в документе, сохраняемом в библиотеку документов.

ShowInListSettings

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

ShowInNewForm

Необязательный атрибут типа Boolean. Если используется значение FALSE, поле не отображается в перечислении Fields, если режим отображения задан как New. Поля, для которых используется данная настройка, не отображаются на странице "Новый элемент" по умолчанию для данного списка. Этим, в частности, можно воспользоваться, чтобы скрыть поля на странице загрузки документов в библиотеку документов.

ShowInVersionHistory

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

ShowInViewForms

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

Sortable

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

SourceID

Необязательный атрибут типа Text. Содержит пространство имен, которое определяет поле, например https://schemas.microsoft.com/sharepoint/v3, или глобальный уникальный идентификатор (GUID) списка, в котором было создано настраиваемое поле.

StaticName

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

StorageTZ

Указывает способ хранения значений даты/времени. Если атрибуту StorageTZ присвоено значение UTC, дата/время обрабатываются в формате универсального времени (UTC). Чтобы указать, что значение даты/времени относится к "абстрактному" времени (то есть, дата и время хранятся в базе данных в том виде, как они были введены пользователем; без преобразования или хранения локального часового пояса), следует исключить атрибут StorageTZ.

StripWS

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

SuppressNameDisplay

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

TextOnly

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

Title

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

Type

Обязательный атрибут типа Text. Тип данных поля (если элемент Field не является дочерним элементом ProjectedFields):

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

В предварительном выпуске Microsoft SharePoint Foundation 2010 атрибут Type имеет другой смысл и может принимать только одно значение ("Lookup"), являясь дочерним атрибутом атрибута ProjectedFields. Дополнительные сведения о подобном использовании атрибута Элемент ProjectedFields (представление) см. в разделе Type.

SharePoint Foundation включает по умолчанию следующие типы данных:

  • AllDayEvent   Указывает круглосуточное событие. Соответствует типу данных SQL bit.

  • Attachments   Хранит URL-адреса для приложений. Соответствует типу данных SQL bit.

  • Boolean   Используется для хранения значения TRUE/FALSE (хранится в базе данных как 0 или 1). Данное поле можно сортировать или группировать.Соответствует типу данных SQL bit и представлен классом SPFieldBoolean.

  • Calculated   Указывает поле, значение которого вычисляется на основе других столбцов. Соответствует типу данных SQL sql_variant и представлен классом SPFieldCalculated.

  • Choice   Позволяет пользователю указать предварительно определенный набор значений, который может быть использован для ввода данных в поле. Типы Choice и Lookup являются наиболее важными полями для сортировки и группировки. Атрибуты BaseType и Format можно использовать для полей выбора. Данное поле можно сортировать или группировать. Если пункту меню присвоено значение, оно используется как подтвержденное значение выбора поля. Если значение не присвоено, выбор подтверждается в виде текстового значения позиции меню. Во всех случаях именно текстовое значение пункта меню отображается в пользовательском интерфейсе (выпадающее меню или текст кнопки-переключателя). Пункты меню в пользовательском интерфейсе редактирования всегда отображаются в том же порядке, в котором объекты заданы в элементе CHOICES. Можно использовать тип MultiChoice, чтобы задать поле Choice, которое реализует окошки меток, что позволяет пользователю выбирать несколько значений. Соответствует типу данных SQL nvarchar и представлен классом SPFieldChoice.

  • Computed   Указывает поле, содержимое которого зависит от другого поля. Например, поле LinkTitleNoMenu равно окружению значения поля "Заголовок" ссылкой. Представлен классомSPFieldComputed.

  • ContentTypeId   Содержит идентификатор типа контента. Сведения о формате идентификаторов типа контента см. в разделе Идентификаторы типов контента. Соответствует типу данных SQL varbinary.

  • Counter   Обычно используется только для полей внутренних идентификаторов. Целочисленные значения задаются автоматически и являются уникальными среди остальных элементов в текущем списке. Тип Counter всегда имеет атрибут "только чтение", и его нельзя задать из формы. Для данного поля можно выполнить сортировку, но не группировку. Соответствует типу данных SQL int.

  • CrossProjectLink   Используется для связывания события в списке SharePoint с сайтом Meeting Workspace; относится конкретно к типу поля "окошко меток", используемому в формах элемента "Создать" и "Редактировать" для создания сайта Meeting Workspace для элемента. Соответствует типу данных SQL bit и представлен классом SPFieldCrossProjectLink.

  • Currency   Позволяет вводить значение валюты. Каждое поле валюты связано с конкретной местной валютой. В остальном обрабатывается так же, как и тип поля Number. Атрибут LCID можно использовать для указания валюты конкретной локали. Атрибуты Decimals, Max и Min можно использовать для типов валют. Для этого поля можно выполнять сортировку и группировку. Соответствует типу данных SQL float и представлен классом SPFieldCurrency.

  • DateTime   Позволяет хранить полные значения даты или времени суток. Атрибут Format используется для указания формата даты, а атрибут StorageTZ — для определения способа хранения значений даты/времени. Для этого поля можно выполнять сортировку и группировку. Для режима отображения порядок форматирования даты определяется региональными настройками ("M/Д/Г" или "Д/M/Г"). В режиме изменения (или в режиме "Создать" для значения элемента Default), значения даты/времени визуализируются в универсальном формате: M/Д/Г чч:мм am/pm. Соответствует типу данных SQL datetime и представлен классом SPFieldDateTime.

  • File   Содержит файл. Соответствует типу данных SQL uniqueidentifier.

  • GridChoice    Содержит шкалу оценки для обзоров. Соответствует типу данных SQL ntext и представлен классом SPFieldRatingScale.

  • Guid   Позволяет использовать глобальные уникальные идентификаторы (GUID). Соответствует типу данных SQL uniqueidentifier.

  • Integer   Позволяет использовать положительные и отрицательные целочисленные значения. Атрибуты Commas и NegativeFormat используются, чтобы задать форматирование целых чисел. Соответствует типу данных SQL int.

  • Lookup   Поведение весьма схоже с поведением поля Choice, за исключением того, что доступные параметры содержатся в другом списке, а не применяются путем жестко заданного выбора значений. Атрибуты List и ShowField можно использовать для полей поиска. Для этого поля можно выполнять сортировку и группировку. Для сортировки и группировки следует использовать значение DisplayField (Заголовок, по умолчанию), а не внешний ключ, который хранится в списке. Соответствует типу данных SQL int и представлен классом SPFieldLookup.

  • LookupMulti   Поле Lookup, которое может содержать несколько значений. Родительский тип: Lookup.

  • ModStat   Содержит статус утверждения контента. Может принимать значения Approved (по умолчанию), Rejected и Pending (хранится в базе данных как 0, 1 или 2 соответственно). Соответствует типу данных SQL int.

  • MultiChoice   Указывает поле Choice, которое реализует окошки меток, позволяя пользователю выбирать несколько значений. Соответствует типу данных SQL ntext и представлен классом SPFieldMultiChoice.

  • MultiColumn   Поле Note, которое имитирует поле, содержащее несколько значений. Примеры многостолбцового типа поля см. в разделе Практическое руководство. Создание определения настраиваемого типа поля. Сведения о многостолбцовых полях см. в разделе Классы настраиваемых полей с множеством столбцов. Родительский тип: Note.

  • 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.

  • Recurrence   Используется для редактирования и определения шаблона рекурсии для элемента в списке событий. Соответствует типу данных SQL bit.

  • Text   Единичная строка текста, введенная в поле редактирования. Для этого поля можно выполнять сортировку и группировку. Атрибут MaxLength используется для определения максимального допустимого количества символов. Соответствует типу данных SQL nvarchar и представлен классом SPFieldText.

  • ThreadIndex   Содержит идентификатор, который указывает относительное положение сообщения в потоке диалога. Соответствует типу данных SQL varbinary.

  • Threading   Тип поля Threading используется при создании и отображении протоколируемых представлений дискуссионного типа. Любой список может содержать столбец протоколирования, однако при его использовании создается специальный пользовательский интерфейс (Он никогда не отображается как стандартное редактируемое поле в форме или как обычный столбец в представлении). Если для поля протоколирования выполняется сортировка, возвращается обход в прямом порядке всех записей в отношении типа "родитель-потомок". Соответствует типу данных SQL varchar.

  • URL   Используется для создания гиперссылок свободной формы. Поле URL-адреса отображается как <A HREF="URL">Описание</A>. Если описание не предоставляется, поле отображается как <A HREF="URL-адрес">URL-адрес</A>. Текст URL-адреса хранится в таблице URL-адресов (DocMd), в которой хранятся все URL-адреса в базах данных SharePoint на сервере. Благодаря этому любые URL-адреса, которые хранятся локально на сервере, могут обновляться посредством адресной привязки ссылки при изменении места назначения. При удалении записи, в которой содержится поле URL-адреса, соответствующая связанная запись из таблицы URL-адресов также удаляется. Для этого поля можно выполнять сортировку и группировку. (Сортировка определяется в соответствии с текстовым описанием, а не с содержимым URL-адреса; если описание не предоставлено, сортировка выполняется как для пробела). Если атрибут Type имеет значение URL, атрибут LinkType можно использовать для указания типа ссылки. Соответствует типу данных SQL nvarchar и представлен классом SPFieldUrl.

  • User   Поле Lookup, которое ссылается на таблицу базы данных "Данные_пользователя". Соответствует типу данных SQL int и представлен классом SPFieldUser.

  • UserMulti   Поле User, которое может содержать несколько значений. Родительский тип: LookupMulti.

  • WorkflowEventType   Указывает тип события рабочего процесса в соответствии с перечислением SPWorkflowHistoryEventType. Родительский тип: Integer.

  • WorkflowStatus   Указывает статус рабочего процесса в соответствии с перечислением SPWorkflowStatus. Соответствует типу данных SQL nvarchar.

UniqueId

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

UnlimitedLengthInDocumentLibrary

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

URLEncode

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

URLEncodeAsURL

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

UserSelectionMode

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

0 — Выбор только имен отдельных пользователей.

1 — Выбор имен отдельных пользователей и групп пользователей.

UserSelectionScope

Необязательный атрибут типа Integer. Указывает диапазон выбора имен пользователей в поле пользователя на форме элемента. Если значение равно 0, для группы SharePoint отсутствуют ограничения. Если значение больше 0, выбор пользователей ограничен членами группы SharePoint, чьи идентификаторы равны заданному значению.

Version

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

Viewable

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

WebId

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

Width

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

WikiLinking

Необязательный атрибут типа Boolean. TRUE, чтобы указать на преобразование вики-ссылок, которые отображаются в виде двойных скобок ([[…]]), в HTML-ссылки, использующие тег <a>.

XName

Необязательный атрибут типа Text. Используется внутренне в XML-формах для обозначения полей, которые были добавлены, удалены или изменены. Данный атрибут не предназначен для общего пользования.

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

CHOICES, Customization, Default, DefaultFormula, DisplayBidiPattern, DisplayPattern, FieldRefs, Formula, FormulaDisplayNames, MAPPINGS, Validation

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

Fields, ProjectedFields

Вхождения

Минимум: 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"/> or <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.

<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>

См. также

Ссылка

Элемент Column (View)

Элемент Column2 (View)

Элемент Field (Field)

Элемент Field (Field Types)

Элемент Field (схема свойств типов поля)

Элемент Field (DeploymentManifest — DeploymentFieldTemplate)

Элемент Field (DeploymentManifest — FieldDataCollection)

Элемент Field (DeploymentManifest — SPFieldCollection)

Элемент Field (View)

Элемент Field (Site)