Элемент Joins (View)
Дата последнего изменения: 9 марта 2015 г.
Применимо к: SharePoint Foundation 2010
В этой статье
Атрибуты
Дочерние элементы
Родительские элементы
Вхождения
Содержит элементы соединения, необходимые для запроса.
<Joins> <Join ... > </Join> <Join ... > </Join> ...</Joins>
Атрибуты
Атрибут |
Описание |
---|---|
Нет |
Не определен |
Дочерние элементы
Родительские элементы
Примечание |
---|
Если элемент Joins используется как часть динамического запроса, а не как часть определения представления списка (когда он является значением свойства SPQuery.Joins, а не Joins), то у него нет родительского элемента. |
Вхождения
Минимум: 0 Максимум: 1 |
Пример
Далее представлен пример элемента Joins с двумя левыми внешними соединениями. CustomerName — это поле подстановки в списке "Заказы". Оно просматривает поле ID списка заказчиков. У списка заказчиков, в свою очередь, есть поле CityName, поле подстановки для списка городов. Первый элемент Join назначает "customers" в качестве псевдонима списка заказчиков. Потомок элемента Eq определяет соединение с помощью тех же исходных и конечных полей, которые составляют связь подстановки. Второй элемент Join назначает "customerCities" в качестве псевдонима списка городов. Он определяет соединение параллельно существующей связи подстановки между списком заказчиков и списком городов.
Псевдонимы необходимы для списков, так как в одном списке может быть несколько соединений и для их различия нужны разные псевдонимы. Например, в дополнение к соединениям заказов и заказчиков, и заказчиков и городов могут быть также соединения заказов и поставщиков, а также поставщиков и городов. В случае последнего соединения списку городов нужно назначить другой псевдоним, например "supplierCities", отличный от того, что используется для соединения заказчиков и городов.
<Joins>
<Join Type=’LEFT’ ListAlias=’customers’>
<Eq>
<FieldRef Name=’CustomerName’ RefType=’Id’ />
<FieldRef List=’customers’ Name=’ID’ />
</Eq>
</Join>
<Join Type=’LEFT’ ListAlias=’customerCities’>
<Eq>
<FieldRef List=’customer’ Name=’CityName’ RefType=’Id’ />
<FieldRef List=’customerCities’ Name=’ID’ />
</Eq>
</Join>
</Joins>