Элемент 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, который указывает, какое действие должно быть применено к набору возвращаемых значений — агрегирующая функция или обозначение конкретного элемента в коллекции. Возможны следующие значения:
Дополнительные сведения об использовании атрибутов 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. Обозначает тип календаря. Возможны следующие значения:
|
||
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. Обозначает тип форматирования числовых значений. Для полей даты/времени возможны следующие значения:
Для полей выбора данному атрибуту может быть присвоено значение 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 можно выполнять ввод символов языка, которые отсутствуют на данной клавиатуре. Возможны следующие значения:
|
||
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. Определяет способ индикации отрицательных значений. Может принимать одно из следующих значений:
|
||
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):
SharePoint Foundation включает по умолчанию следующие типы данных:
|
||
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 |
Родительские элементы
Вхождения
Минимум: 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>
См. также
Ссылка
Элемент Field (схема свойств типов поля)
Элемент Field (DeploymentManifest — DeploymentFieldTemplate)
Элемент Field (DeploymentManifest — FieldDataCollection)