Элемент FieldRef (Query)

Статья
04/21/2015

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

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

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

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

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

Атрибуты

Атрибут	Описание
Alias	Необязательный атрибут типа Text.
Ascending	Необязательный атрибут типа Boolean. Указывает порядок сортировки в элементе FieldRef, заданный в представлении. Значение по умолчанию TRUE.
CreateURL	Необязательный атрибут типа Text. Указывает URL-адрес для ASCX-файла, используемого для создания сайта "Рабочая область для собраний".
DisplayName	Необязательный Text. Этот атрибут предоставляет отображаемое имя поля, на которое делается ссылка.
Explicit	Необязательный атрибут типа Boolean. Этот атрибут поддерживается только в элементе ViewFields. Значение TRUE, если поле явно объявлено в определении представления и не возвращается в перечислении Fields в представлении.
Format	Необязательный атрибут типа Text.
ID	Необязательный атрибут типа Text. Задает GUID, идентифицирующий поле.
Key	Необязательный атрибут типа Text. Значение Primary указывает, что это первичный ключ для таблицы, уникально идентифицирующий каждую запись таблицы.
List	Необязательный атрибут типа Text. Определяет родительский внешний список, если элемент FieldRef является потомком элемента Eq в элементе Join. Его значение — псевдоним списка, который задается атрибутом ListAlias элемента Join.
Name	Необязательный атрибут типа Text. Этот атрибут предоставляет внутреннее имя поля, на которое делается ссылка.
RefType	Необязательный атрибут типа Text. Задает тип ссылки для поля в списке событий.
ShowField	Необязательный атрибут типа Text. В качестве значения атрибута ShowField можно установить имя поля для отображения. По умолчанию это текст гиперссылки из поля Title записи, отображаемой во внешнем списке. Но атрибут ShowField можно использовать для переопределения этого значения и отображения другого поля из внешнего списка. Следующие типы данных разрешено использовать как целевые для атрибута ShowField: Text, Choice и Counter.
TextOnly	Необязательный атрибут типа Boolean. Указывает, что поле содержит только текстовые значения.
Type	Необязательный атрибут типа Text. Указывает функцию, которая применяется к итоговым или вычисляемым столбцам. Возможны следующие значения. AVG Среднее значение. Применяется к типам полей DateTimeNumber, Integer и Currency. COUNT Количество элементов. Применяется ко всем типам полей, позволяющим вычисления. MAX Максимальное значение. Применяется к типам полей DateTimeNumber, Integer и Currency. MIN Минимальное значение. Применяется к типам полей DateTimeNumber, Integer и Currency. SUM Сумма значений. Применяется к типам полей Number, Integer и Currency. STDEV Стандартное отклонение. Применяется к типам полей Number, Integer и Currency. VAR Дисперсия. Применяется к типам полей Number, Integer и Currency. Значения для атрибута Type не зависят от регистра символов.

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

Нет

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

BeginsWith, Contains, DateRangesOverlap, Eq, FieldRefs, Geq, GroupBy, Gt, In, Includes, IsNotNull, IsNull, Leq, Lt, Neq, NotIncludes, OrderBy

Вхождения

Минимум: 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>

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