Элемент ProjectedFields (View)

Статья
04/08/2023

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

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

<ProjectedFields>
  <Field ... />
  <Field ... />
</ProjectedFields>

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

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

Атрибуты

Нет

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

Поле

Примечание.

Существует максимальное количество дочерних элементов Field. Оно задается как разница между максимальным количеством разрешенных полей в списке и числом полей, которые уже есть в списке.

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

Просмотр

Occurrences

Минимум: 0
Максимум: 1

Примечание.

В элементе View не может быть элемента ProjectedFields, если в нем нет элемента Joins хотя бы с одним дочерним элементом Join. Однако элемент ProjectedFields , который формирует значение свойства SPQuery.ProjectedFields и, следовательно, не является дочерним элементом элемента View , можно использовать для поддержки неявного соединения без элемента Joins .

Не рекомендуется работать с элементом Joins. Вы сможете максимально повысить вероятность совместимости решения с будущими выпусками Microsoft SharePoint Foundation, всегда используя явный элемент Join . Дополнительные сведения о неявном объединении с элементами ProjectedFields см. в статье List Joins and Projections.

Замечания

Если поле из объединенного списка не представлено в ProjectedFields, его нельзя включить в элемент ViewFields.

Пример

В следующем примере показано, как добавить другое поле к результатам, возвращенным запросом. Значение атрибута List — это псевдоним внешнего списка. Псевдоним определяется в элементе Join (View). Значение атрибута ShowField должно быть являться внутренним именем внешнего списка поля.

Атрибут Type не указывает тип данных поля, как это обычно происходит в элементе Field. Если элемент Field является потомком элемента ProjectedFields, Type просто указывает, основан ли элемент Join (в элементе Joins, от которого зависит элемент ProjectedFields) на существующем отношении подстановки между списками. С SharePoint Foundation 2010 все соединения должны основываться на существующем отношении подстановки, поэтому тип всегда имеет значение "Уточняющий запрос". Фактический тип данных поля не указывается, если оно является потомком элемента ProjectedFields. Однако тип данных поля имеет значение, так как в элемент ProjectedFields могут быть включены только следующие типы полей:

Calculated (вычисляемое поле, трактуется как обычный текст);
ContentTypeId
Счетчик
Валюта
DateTime
Guid
Целое число
Note (примечание, только однострочное);
Числовой
Текст

<ProjectedFields>
  <Field
    Name='CustomerCity'
    Type='Lookup'
    List='customerCities'
    ShowField='Title' />
</ProjectedFields>

Пример элемента ProjectedFields, в дочернем элементе Field которого присутствует атрибут FieldRef вместо атрибута List, см. в статье List Joins and Projections.

Share via