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>