Свойство SPQuery.Joins

Статья
05/13/2015

Получает или задает раздел соединения элемента запроса, включая все его дочерние элементы.

Пространство имен: Microsoft.SharePoint
Сборка: Microsoft.SharePoint (в Microsoft.SharePoint.dll)

Синтаксис

'Декларация
Public Property Joins As String
    Get
    Set
'Применение
Dim instance As SPQuery
Dim value As String

value = instance.Joins

instance.Joins = value

public string Joins { get; set; }

Значение свойства

Тип: System.String
Соединяет элемент XML.

Замечания

Дочерний элемент соединения элемента объединения представляется каждого соединения. Разрешены только внутренние и левого внешнего соединения. Кроме того поля в основной список должен быть типа полем поиска, которое ищет в поле внешнего списка. Может быть соединения для нескольких списков, объединения списка и цепочки соединений. Если заданный список внешнего списка в более одного соединения, она должна иметь различные псевдонимы, выданных ListAlias атрибуты соединения элементов, представляющих соединения.

Примеры

Далее представлен пример элемента 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=’customers’ Name=’CityName’ RefType=’Id’ />
      <FieldRef List=’customerCities’ Name=’ID’ />
    </Eq>
  </Join>
</Joins>

См. также

Справочные материалы

SPQuery класс

Элементы SPQuery

Пространство имен Microsoft.SharePoint

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