Элемент FieldRef (Query)

Применимо к: SharePoint 2016 | SharePoint Foundation 2013 | SharePoint Online | SharePoint Server 2013

Представляет ссылку на поле в запросе.

<FieldRef
  Alias = "Text"
  Ascending = "TRUE" | "FALSE"
  CreateURL = "Text"
  DisplayName = "Text"
  Explicit = "TRUE" | "FALSE"    Format = "Text"
  ID = "Text"
  Key = "Text"  List = "Text"
  LookupId = "TRUE" | "FALSE"
  Name = "Text"
  RefType = "Text"
  ShowField = "Text"
  TextOnly = "TRUE" | "FALSE"
  Type = "Text">
</FieldRef>

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

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

Атрибуты

Атрибут Описание
Alias
Необязательный текст.
Ascending
Необязательный логический. Указывает порядок сортировки в элементе FieldRef, определенном в представлении. Значение по умолчанию — TRUE.
CreateURL
Необязательный атрибут типа Text. Задает URL-адрес для ASPX-файла, который используется для создания веб-сайта рабочей области для собраний.
DisplayName
Необязательный атрибут типа Text. Предоставляет отображаемое имя поля, на которое указывает ссылка.
Explicit
Необязательный логический. Этот атрибут поддерживается только в пределах элемента ViewFields. Имеет значение TRUE, если это поле явно объявлено в определении представления и не возвращается с перечислением Fields в представлении.
Format
Необязательный текст.
ID
Необязательный атрибут типа Text. Указывает идентификатор GUID для поля.
Ключ
Необязательный текст. Если для него задано значение Primary, указывает на то, что поле является первичным ключом для таблицы, однозначно идентифицируя каждую запись в таблице.
List
Необязательный текст. Задает внешний родительский список, когда элемент FieldRef является дочерним элементом Eq в элементе Join. Это значение — псевдоним списка, определяемого атрибутом ListAlias элемента Join.
Lookupid
Необязательный логический. Когда поле имеет тип Lookup, этот атрибут указывает на то, что при запросах должен выполняться поиск элемента по его уникальному идентификатору, а не по значению поля. Это может пригодиться, если несколько элементов имеют одинаковые значения в поле, а нужно запросить один из них. Значение по умолчанию — False.
Имя
Необязательный атрибут типа Text. Предоставляет внутреннее имя поля, на которое указывает ссылка.
RefType
Необязательный атрибут типа Text. Указывает тип ссылки для поля в списке событий.
ShowField
Необязательный текст. Атрибут ShowField можно задать для отображаемого имени поля. По умолчанию отображается текст с гиперссылкой из поля "Заголовок" записи во внешнем списке. Но атрибут ShowField можно использовать для переопределения и отображения другого поля из внешнего списка.
Следующие типы данных можно использовать как целевые в атрибуте ShowField: Text, Choice и Counter.
TextOnly
Необязательный логический. Указывает на то, что поле содержит только текстовые значения.
Тип
Необязательный атрибут типа Text. Указывает функцию, которая применяется к столбцу итогов или вычисляемому столбцу. Возможные значения:

СРЕДНЯЯ Среднее значение. Применяется к типам полей DateTimeNumber, Integer и Currency.
РАССЧИТЫВАТЬ Количество элементов. Применяется ко всем типам поля, допускающим агрегирование.
МАКС Максимальное значение. Применяется к типам полей DateTimeNumber, Integer и Currency.
МИН Минимальное значение. Применяется к типам полей DateTimeNumber, Integer и Currency.
СУММА Сумма значений. Применяется к типам полей Number, Integer и Currency.
STDEV Стандартное отклонение. Применяется к типам полей Number, Integer и Currency.
VAR Отклонение. Применяется к типам полей Number, Integer и Currency.

В значениях атрибута Type не учитывается регистр.

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

Нет

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

Occurrences

  • Минимум: 0
  • Максимум: 1 (без ограничений в OrderBy)

Примеры

В приведенном ниже примере запрос отправляется в тех случаях, когда поле "Expires" имеет значение null или содержит значение, которое больше или равно текущей дате.

<Query>
   <Where>
      <Or>
         <IsNull>
            <FieldRef Name="Expires" />
         </IsNull>
         <Geq>
            <FieldRef Name="Expires" />
            <Value Type="DateTime">
               <Today />
            </Value>
         </Geq>
      </Or>
   </Where>
   <OrderBy>
      <FieldRef Name="Modified" Ascending="FALSE" />
   </OrderBy>
</Query>

В этом примере из файла Schema.xml для списков контактов поля, отображаемые на панели инструментов.

<ViewFields>
   <FieldRef Name="LinkTitleNoMenu"></FieldRef>
   <FieldRef Name="FirstName"></FieldRef>
   <FieldRef Name="WorkPhone"></FieldRef>
   <FieldRef Name="Email"></FieldRef>
</ViewFields>

  • Last updated on