Элемент FieldRef (Query)

Статья
04/08/2023

Применимо к: 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>

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