Элемент ProjectedFields (представление)

Статья
04/21/2015

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

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

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

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

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

Атрибуты

Нет

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

Field

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

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

View

Вхождения

Примечание
В элементе View не может быть элемента ProjectedFields, если в нем нет элемента Joins хотя бы с одним дочерним элементом Join. Однако элемент ProjectedFields, который формирует значение свойства SPQuery.ProjectedFields и, следовательно, не является потомком элемента View, можно использовать для поддержки неявного объединения без элемента Joins. Не рекомендуется работать с элементом Joins. Можно повысить степень совместимости решения с будущими выпусками Microsoft SharePoint Foundation, если всегда использовать явный элемент Join. Дополнительные сведения о неявном объединении с элементами ProjectedFields см. в статье Соединения списков и проекции.

В элементе View не может быть элемента ProjectedFields, если в нем нет элемента Joins хотя бы с одним дочерним элементом Join. Однако элемент ProjectedFields, который формирует значение свойства SPQuery.ProjectedFields и, следовательно, не является потомком элемента View, можно использовать для поддержки неявного объединения без элемента Joins. Не рекомендуется работать с элементом Joins. Можно повысить степень совместимости решения с будущими выпусками Microsoft SharePoint Foundation, если всегда использовать явный элемент Join. Дополнительные сведения о неявном объединении с элементами ProjectedFields см. в статье Соединения списков и проекции.

Минимум: 0

Максимум: 1

Примечания

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

Пример

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

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

Calculated (вычисляемое поле, трактуется как обычный текст);
ContentTypeId (идентификатор типа контента);
Counter (счетчик);
Currency (денежное значение);
DateTime
Guid (глобальный уникальный ИД);
Integer (целое значение);
Note (примечание, только однострочное);
Number (числовое значение);
Text (текст).

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

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

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