Элемент Field (Field)

Статья
04/21/2015

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

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

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

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

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

Атрибуты

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, если поле может быть удалено.

AllowDuplicateValues

Необязательный атрибут типа Boolean. Указывает, разрешены ли дублирующие значения в данном поле списка. Значение false, запрещающее ввод дублирующих значений, фактически задает для поля поведение первичного ключа. True, если в поле разрешено дублирование значений; в противном случае — false. По умолчанию используется значение true.

AllowHyperlink

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

AllowMultiVote

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

AppendOnly

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

AuthoringInfo

Необязательный атрибут типа Text. Описательная строка, отображаемая на страницах редактирования полей для обозначения поля и его назначения; например, поле LinkTitle имеет описание «(ссылка на элемент)». Этот атрибут обычно используется при наличии поля с тем же именем, используемого для другой цели.

BaseType

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

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

Commas

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

Customization

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

Decimals

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

DefaultListField

Необязательный атрибут типа Boolean. Получается значение, задающее режим отображения формы Изменение свойств для файла при отправке файла в библиотеку документов. True, если добавляемое в библиотеку поле не имеет видимой формы Изменение свойств; в противном случае — false. По умолчанию — false.

Description

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

Dir

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

DisplaceOnUpgrade

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

DisplayImage

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

DisplayName

Необязательный атрибут типа Text. Отображаемое имя поля. Ограничение на использование пробелов отсутствует. Максимальная длина — 255 знаков. Значение может быть ссылкой на ресурс в формате $Resources:String. Дополнительные сведения см. в разделе Локализация решений SharePoint.

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

DisplayNameSrcField

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

DisplaySize

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

Div

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

EnableLookup

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

ExceptionImage

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

FieldRef

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

FillInChoice

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

Filterable

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

FilterableNoRecurrence

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

ForcedDisplay

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

Format

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

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

DateOnly Отображение (и разрешение изменения) только даты (для всех измененных значений задается время 12:00).
DateTime Отображение и изменение как даты, так и времени (по умолчанию).
ISO8601 Отображение даты и времени в формате ISO8601 с преобразованием к формату времени UTC: YYYY-MM-DDTHH:MM:SSZ. Этот формат используется для свойств документов в 2007 системы Microsoft Office, а также для стандартного формата обмена, используемого в SharePoint Foundation между формами New и Edit и сервером.
ISO8601Basic Использование сокращенной формы форматов даты и времени 8601: YYYYMMDDTHHMMSSZ. Этот формат используется для 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, преобразуются в сущности.

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

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, если данное поле возвращено методом GetRelatedFields() из другого списка.

JoinColName

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

JoinRowOrdinal

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

JoinType

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

LCID

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

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

List

Необязательный атрибут типа Text. Используется для обозначения списка, являющегося целевым для поля подстановки (Type="Lookup").

Если целевой список уже существует, значением атрибута List должно быть строковое представление GUID (включая фигурные скобки) целевого списка. Если целью является тот же список, к которому принадлежит поле, можно указать "Self".

Если целевой список еще не существует, значением атрибута List может быть указанный относительно веб-сайта URL-адрес, такой как "Lists/My List", но только при создании целевого списка в той же функции, в которой создано поле подстановки. В этом случае значение атрибута List в элементе Field должно совпадать со значением атрибута Url в элементе ListInstance, создающем целевой список.

Max

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

MaxLength

Необязательный атрибут типа Integer. Задает максимальное число знаков, допустимое в значении поля. Изменяемые формы приводятся в соответствие с этим значением, которое проверяется в клиентском приложении. При попытке ввести больше знаков, чем задано в параметре MaxLength, отображается сообщение об ошибке.

Min

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

Mult

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

Name

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

NegativeFormat

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

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

Node

Необязательный атрибут типа Text. Используется в формах XML, этот атрибут является обязательным для всех полей, кроме ссылок инструкций обработки, и указывает выражение XPath для узла, уровень которого повышается.

NoEditFormBreak

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

NumLines

Необязательный атрибут типа Integer. Рекомендует число строк для отображения в блоке TEXTAREA при редактировании. Это просто подсказка в клиентском пользовательском интерфейсе — никакого ограничения по числу строк редактируемого текста не существует.

Overwrite

Необязательный атрибут типа Boolean. Указывает, перезаписывает ли определение нового поля, активированное на сайте (SPWeb), определение существующего поля в случаях, когда новое поле имеет такой же идентификатор, как и существующее поле. True, если новое поле перезаписывает существующее поле с тем же идентификатором; в противном случае — false. По умолчанию — false.

Однако следует иметь в виду, что если существующее поле доступно только для чтения или запечатано, оно не будет перезаписано активируемым полем, даже если данный атрибут имеет значение true.

OverwriteInChildScopes

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

Percentage

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

PIAttribute

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

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

PITarget

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

PrependId

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

Presence

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

PrimaryKey

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

PrimaryPIAttribute

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

PrimaryPITarget

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

ReadOnly

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

ReadOnlyEnforced

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

RelationshipDeleteBehavior

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

Для столбца сайта этот атрибут не должен иметь значение Cascade или Restrict. Допускается значение None (по умолчанию) либо можно опустить атрибут.

При указании любого значения, отличного от None необходимо также указать значение TRUE для атрибута Indexed и значение FALSE для атрибута Mult.

RenderXMLUsingPattern

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

Required

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

RestrictedMode

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

ResultType

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

RichText

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

RowOrdinal

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

Sealed

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

SeparateLine

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

SetAs

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

ShowAddressBookButton

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

ShowField

Необязательный атрибут типа Text. Когда атрибут Type имеет значение "Lookup", значение атрибута ShowField указывает внутренне имя целевого поля для подстановки. Если значение не указано, отображается указанный гиперссылкой текст из поля заголовка записи в целевом списке.

В качестве цели поля подстановки разрешены следующие типы полей: Counter, DateTime, Number и Text. Тип поля Computed может быть целью, если подстановки включены. Дополнительные сведения см. в описании свойства EnableLookup класса SPFieldComputed. Тип поля Calculated может быть целью, если выходные данные являются текстом. Дополнительные сведения см. в описании свойства OutputType класса SPFieldCalculated.

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. Содержит внутренне имя поля, которое не может быть уникальным в коллекции полей. Однако, в отличие от атрибута Name, который может быть исправлен для обеспечения его уникальности, значение атрибута StaticName присваивается полю в точности как определено. В последствии можно использовать это значение в коде для получения ссылки на поле посредством вызова метода TryGetFieldByStaticName.

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 с сайтом рабочей области для собраний; ссылается на тип поля флажка, используемого в формах создания и изменения элемента для создания рабочей области для собратий для данного элемента. Соответствует типу данных SQL bit и представлено классом SPFieldCrossProjectLink.
Currency Разрешает ввод денежного значения. Каждое поле валюты связано с валютой определенного языкового стандарта. Во всех прочих отношениях оно обрабатывается как тип поля Number. Используйте атрибут LCID для указания валюты определенного языкового стандарта. Атрибуты Decimals, Max и Min могут использоваться для типов валюты. Это поле поддерживает сортировку и группировку. Соответствует типу данных SQL float и представлено классом SPFieldCurrency.
DateTime Разрешает хранение полных значений даты или времени. Используйте атрибут Format для указания форматирования даты и атрибут StorageTZ для определения способа хранения значений даты и времени. Это поле поддерживает сортировку и группировку. Для режима отображения порядок форматирования даты извлекается из региональных параметров ("M/D/Y" или "D/M/Y"). В режиме редактирования (или режиме создания для значения элемента Default) значения даты и времени отображаются в универсальном формате: M/D/Y hh:mm am/pm. Соответствует типу данных SQL datetime SQL и представлено классом 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, ссылающееся на таблицу базы данных UserInfo. Соответствует типу данных SQL int и представлено классом SPFieldUser.
UserMulti Поле User, которое может содержать более одного значения. Родительский тип: LookupMulti.
WorkflowEventType Указывает тип события рабочего процесса согласно перечислению SPWorkflowHistoryEventType. Родительский тип: Integer.
WorkflowStatus Указывает состояние рабочего процесса согласно перечислению SPWorkflowStatus. Соответствует типу данных SQL nvarchar.

UniqueId

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

UnlimitedLengthInDocumentLibrary

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

URLEncode

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

URLEncodeAsURL

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

UserSelectionMode

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

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

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

UserSelectionScope

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

Viewable

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

Width

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

WikiLinking

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

XName

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

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

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

Elements

Примечания

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

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

Пример

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

<?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://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>

См. также

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

Элемент Field (Field)

Атрибуты

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

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

Примечания

Пример

См. также

Ссылка

Концепции

Другие ресурсы

Дополнительные ресурсы