SPView.Joins 属性

获取或设置用于定义视图的 XML 的加入元素部分。

命名空间:  Microsoft.SharePoint
程序集:  Microsoft.SharePoint(位于 Microsoft.SharePoint.dll 中)

语法

声明
Public Property Joins As String
    Get
    Set
用法
Dim instance As SPView
Dim value As String

value = instance.Joins

instance.Joins = value
public string Joins { get; set; }

属性值

类型:System.String
加入XML 和其子元素。

备注

每个联接的联接联接元素元素子表示。只有内部和左外部联接被允许。此外,主列表中的字段必须是查找到外列] 列表中的字段的查找类型字段。可以对多个列表联接,链的连接在同一个列表中,与多个联接。如果给定的列表中多个联接的外部列表,它必须由表示联接的联接元素的ListAlias属性分配给它的不同的别名。

示例

下面是一个带有两个左外部联接的 Joins 元素的示例。CustomerName 是 Orders 列表上的查阅字段。它查阅 Customers 列表的 ID 字段。而 Customer 列表具有一个 CityName 字段,该字段又是 Cities 列表的查阅字段。第一个 Join 元素将"customers"指派为 Customers 列表的别名。Eq 元素的子元素定义使用构成查阅关系的相同源和目标字段的联接。第二个 Join 元素将"customerCities"指派为 Cities 列表的别名。它定义与 Customer 和 Cities 列表之间的现有查阅关系平行的联接。

别名对列表而言非常重要,因为同一列表上可能存在多个联接,需要使用不同的别名区分这些联接。例如,除了从 Orders 到 Customer 以及从 Customer 到 Cities 的联接外,可能还存在从 Orders 到 Suppliers 以及从 Suppliers 到 Cities 的联接。在最后一种联接中,将为 Cities 列表指派一个不同于从 Customer 到 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=’customers’ Name=’CityName’ RefType=’Id’ />
      <FieldRef List=’customerCities’ Name=’ID’ />
    </Eq>
  </Join>
</Joins>

另请参阅

引用

SPView 类

SPView 成员

Microsoft.SharePoint 命名空间