通过

Joins 元素 (视图)

  • 项目

适用于： SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013

包含查询所需的 Join 元素。

<Joins>  <Join ... >  </Join>    <Join ... >  </Join>  ...</Joins>

元素和属性

下面各部分介绍了属性、子元素和父元素。

Attributes

无

子元素

父元素

注意

当 Joins 元素用作动态查询的一部分而不是作为列表视图定义的一部分时;也就是说，当它是 SPQuery.Joins 属性而不是 Joins 属性的值时，它实际上没有父元素。

出现次数

  • 最小值：0
  • 最大值：1

示例

下面是一个带有两个左外部联接的 Joins 元素的示例。 CustomerName 是 Orders 列表上的查阅字段。 它查阅 Customers 列表的 ID 字段。 而 Customer 列表具有一个 CityName 字段，该字段又是 Cities 列表的查阅字段。

第一个 Join 元素将“customers”指定为“客户”列表的别名。 Eq 元素的子元素定义使用构成查阅关系的相同源和目标字段的联接。 第二个 Join 元素将“customerCities”作为别名分配给城市列表。 它定义与 Customer 和 Cities 列表之间的现有查阅关系平行的联接。

别名对列表而言是必需的，因为同一列表上可能存在多个联接，需要使用不同的别名区分这些联接。 例如，除了从 Orders 到 Customer 以及从 Customer 到 Cities 的联接外，可能还存在从 Orders 到 Suppliers 以及从 Suppliers 到 Cities 的联接。 对于最后一个联接，将从用于客户到城市联接的别名（如“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>