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

Элемент FieldRef (ContentType)

  • Статья

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

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

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

Указывает столбец для ссылки в этом типе контента.

<FieldRef
  Aggregation="sum" | "count" | "average" | "min" | "max" | "merge" | "plaintext" | "first" | "last"
  Customization="Text"
  DefaultValue="Text"
  Description="Text"
  DisplayName="Text"
  Format="Text"
  Filterable="TRUE" | "FALSE"
  FilterableNoRecurrence="TRUE" | "FALSE"
  FromBaseType="TRUE" | "FALSE"
  Hidden="TRUE" | "FALSE" | "orResource"
  ID="Text"
  Locked="TRUE" | "FALSE"
  Name="Text"
  Node="Text"
  NumLines="Integer"
  PIAttribute="Text"
  PITarget="Text"
  PrimaryPIAttribute="Text"
  PrimaryPITarge="Text"
  ReadOnly="TRUE" | "FALSE"
  ReadOnlyClient="TRUE" | "FALSE"
  Required="TRUE" | "FALSE"
  Sealed="TRUE" | "FALSE"
  ShowInDisplayForm="TRUE" | "FALSE"
  ShowInEditForm="TRUE" | "FALSE"
  ShowInFileDlg="TRUE" | "FALSE"
  ShowInListSettings="TRUE" | "FALSE"
  ShowInNewForm="TRUE" | "FALSE"
  Sortable="TRUE" | "FALSE">
</FieldRef>

Атрибуты

Атрибут

Описание

Aggregation

При использовании атрибута Node, чтобы указать выражение XPath, которое возвращает коллекцию значений, также можно включить атрибут Aggregation, указывающий действие, которое необходимо выполнить с возвращенным набором значений.

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

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

  • sum

  • count

  • average

  • min

  • max

  • merge

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

  • first   Применяет повышение и понижение свойств к первому элементу в коллекции.

  • last   Применяет повышение и понижение свойств к первому элементу в коллекции.

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

Customization

Необязательный атрибут типа Text. Строка на языке Collaborative Application Markup Language (CAML), которая определяет свойства пользовательского поля.

DefaultValue

Устарело.

Description

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

DisplayName

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

Значение этого атрибута используется в качестве заголовка столбца, когда поле отображается в представлении таблицы, и в качестве надписи формы, когда поле отображается в форме. Атрибут DisplayName используется для изменения отображаемого имени на значение, отличное от имени, определенного в самом поле.

Format

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

Для столбцов даты/времени возможны следующие значения.

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

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

  • ISO8601   Отображение даты и времени в формате времени ISO8601, преобразованном в UTC: YYYY-MM-DDTHH:MM:SSZ.

    Это формат, используемый для свойств документов в Microsoft Office, а также используемый в качестве стандартного формата обмена данными в Microsoft SharePoint Foundation между формами "Создать" и "Изменить" и сервером.

  • ISO8601Basic   Используйте сокращенную форму форматов даты и времени 8601: YYYYMMDDTHHMMSSZ.

    Это формат, используемый для vCard/iCal.

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

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

Filterable

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

FilterableNoRecurrence

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

FromBaseType

Необязательный атрибут типа Boolean. Вместо этого атрибута рекомендуется атрибут Sealed.

Hidden

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

Если не включить этот атрибут, SharePoint Foundation рассматривает столбец так, как если бы атрибут имел значение FALSE.

ID

Обязательный параметр типа Text. Задает идентификатор поля столбца, на который указывает этот элемент FieldRef. Идентификатор поля — это строковое представление GUID-идентификатора, включая скобки. Для значения учитывается регистр.

Идентификаторы встроенных полей можно найти в файле fieldswss.xml, расположенном в следующей папке: %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES\fields.

Locked

Устарело.

Name

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

Node

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

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

NumLines

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

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.

PrimaryPIAttribute

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

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

Используется для повышения и понижения свойства в XML-документах.

Дополнительные сведения об использовании атрибутов 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, поле не отображается в формах New или Edit, но может быть включено в представления. Задание атрибуту Hidden значения TRUE полностью скрывает поле из пользовательского интерфейса.

Если не включить этот атрибут, SharePoint Foundation рассматривает столбец так, как если бы атрибут имел значение FALSE.

Required

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

Sealed

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

Если не включить этот атрибут, SharePoint Foundation рассматривает столбец так, как если бы атрибут имел значение FALSE.

ShowInDisplayForm

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

ShowInEditForm

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

ShowinFileDlg

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

ShowInListSettings

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

ShowInNewForm

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

Sortable

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

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

Отсутствуют.

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

Элемент FieldRefs (ContentType)

Вхождения

Минимум: 0

Максимум: без ограничений

Примечания

Элемент FieldRef — это ссылка на столбец, определенный в другом месте, на уровне сайта или списка. В ссылке поля можно переопределить подмножество свойств столбца, например следующие:

  • Отображаемое имя

  • XML повышение и понижение атрибутов

  • Является ли поле доступным только для чтения, обязательным или скрытым

Изменение этих свойств в ссылке поля изменяет их только при их применении к определенному типу контента, в котором содержится ссылка поля.

Важное примечаниеВажно!

Атрибуты ID, Name, DisplayName и Required всегда обязательны, даже когда элемент FieldRef указывает на поле, определенное в том же манифесте элемента.

Пример

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

<FieldRefs>
  <!--  Built-in Title field -->
  <FieldRef ID="{fa564e0f-0c70-4ab9-b863-0177e6ddd247}" Name="Title" DisplayName="Item" Required="TRUE" Sealed="TRUE"/>
  <!--  Custom CostCenter field -->
  <FieldRef ID="{943E7530-5E2B-4C02-8259-CCD93A9ECB18}" Name="CostCenter" DisplayName="Department" Required="TRUE"/>
</FieldRefs>

См. также

Ссылка

SPFieldLink

Концепции

Определения типов контента

Поля и ссылки на поля