连接信息类。用于矢量数据集与外部表的连接。外部表可以为另一个矢量数据集（其中纯属性数据集中没有空间几何信息）所对应的DBMS表，也可以是用户自建的业务表。需要注意的是，矢量数据集与外部表必须属于同一数据源。
程序集： SuperMap.Data (in SuperMap.Data)
版本: dll
语法
| C# |
|---|
public class JoinItem : IDisposable |
备注
当两个表格之间建立了连接，通过对主表进行操作，可以对外部表进行查询，制作专题图以及分析等。当两个表格之间是一对一或多对一的关系时，可以使用join连接。当为多对一的关系时，允许指定多个字段之间的关联。该类型的实例可被创建。
数据集表之间的联系的建立有两种方式，一种是连接（join），一种是关联（link）。连接的相关设置是通过 JoinItem 类实现的，关联的相关设置是通过 LinkItem 类实现的，另外，用于建立连接的两个表必须在同一个数据源下，而用于建立关联关系的两个数据集表可以不在同一个数据源下。
下面通过查询的例子来说明连接和关联的区别，假设用来进行查询的数据集表为 DatasetTableA，被关联或者连接的表为 DatasetTableB，现通过建立 DatasetTableA 与 DatasetTableB 的连接或关联关系来查询 DatasetTableA中满足查询条件的记录:
1.连接（join）
设置将 DatasetTableB 连接 DatasetTableA 的连接信息，即建立 JoinItem 类并设置其属性，当执行 DatasetTableA 的查询操作时，系统将根据连接条件及查询条件，将满足条件的 DatasetTableA 中的内容与满足条件的 DatasetTableB 中的内容构成一个查询结果表，并这个查询表保存在内存中，需要获取结果时，再从内存中取出相应的内容。
2.关联（link）
设置将 DatasetTableB（副表）关联到 DatasetTableA（主表）的关联信息，即建立 LinkItem 类并设置其属性，DatasetTableA 与 DatasetTableB 是通过主表 DatasetTableA 的外键（ LinkItem.ForeignKeys 属性）和副表 DatasetTableB 的主键（ LinkItem.PrimaryKeys 属性）实现关联的，当执行 DatasetTableA 的查询操作时，系统将根据关联信息中的过滤条件及查询条件，分别查询 DatasetTableA 与 DatasetTableB 中满足条件的内容，DatasetTableA 的查询结果与 DatasetTableB 的查询结果分别作为独立的两个结果表保存在内存中，当需要获取结果时，SuperMap 将对两个结果进行拼接并返回，因此，在应用层看来，连接和关联操作很相似。
3.LinkItem 只支持左连接，UDB、PostgreSQL 和 DB2 数据源不支持 LinkItem，即对 UDB、PostgreSQL 和 DB2 类型的数据引擎设置 LinkItem 不起作用；
4.JoinItem 目前支持左连接和内连接，不支持全连接和右连接，UDB 引擎不支持内连接；
5.使用 LinkItem 的约束条件：空间数据和属性数据必须有关联条件，即主空间数据集与外部属性表之间存在关联字段。主空间数据集：用来与外部表进行关联的数据集。外部属性表：用户通过 Oracle 或者 SQL Server 创建的数据表，或者是另一个矢量数据集所对应的 DBMS 表。
示例
以下代码示范如何构造一个连接信息类，并将其添加到连接信息集合中。
假设打开一个工作空间workspace，工作空间中存在一个数据源 datasource 对象。
CopyC#public void JoinItemSample(Workspace workspace, Datasource datasource) { // 从数据源里得到名为“World”和“Capital”的数据集，分别为 datasetVector 和 datasetVector1，两个数据集都有 capital 字段 DatasetVector datasetVector = datasource.Datasets["World"] as DatasetVector; DatasetVector datasetVector1 = datasource.Datasets["Capital"] as DatasetVector; // 构造连接信息类对象，获得用于连接的表名 JoinItem joinitem = new JoinItem(); String foreignTableName = datasetVector1.TableName; // 设置连接信息类的属性 joinitem.ForeignTable = foreignTableName; joinitem.JoinFilter = "World.capital=" + foreignTableName + ".capital"; joinitem.JoinType = JoinType.LeftJoin; joinitem.Name = "Connect"; // 设置连接信息集合类，将连接信息加入到连接信息集合中 JoinItems joinitems = new JoinItems(); joinitems.Add(joinitem); // 生成利用外接表制作的默认标签专题图 ThemeLabel themelabel = ThemeLabel.MakeDefault(datasetVector, foreignTableName + ".SmID", RangeMode.EqualInterval, 10.0, ColorGradientType.Rainbow, joinitems); themelabel.LabelExpression = "country"; }
继承层次
SuperMap.Data..::.JoinItem
