AddWithKey 相关技术

DataAdapter 的 Fill 方法仅使用数据源中的表列和表行来填充 DataSet；虽然约束一般由数据源来设置，但在默认状况下，Fill 方法不会将此架构信息添加到 DataSet 中。若要使用数据源中的现有主键约束信息填充 DataSet，则能够调用 DataAdapter 的 FillSchema 方法，或者在调用 Fill 以前将 DataAdapter 的 MissingSchemaAction 属性设置为 AddWithKey。这将确保 DataSet 中的主键约束反映数据源中的主键约束。外键约束信息不包含在内，将须要显式建立，如将约束添加到表所示。

若是在使用数据填充 DataSet 以前向其中添加架构信息，将确保将主键约束与 DataSet 的 DataTable 对象包含在一块儿。这样，当再次调用 Fill 来填充 DataSet 时，将使用主键列信息来匹配数据源中的新行和每一个 DataTable 中的当前行，而且使用数据源中的数据改写表中的当前数据。若是没有架构信息，来自数据源的新行将追加到 DataSet，从而致使重复的行。

注意 若是数据源中的某列被标识为自动递增列，则 MissingSchemaAction 为 AddWithKey 的 FillSchema 方法或 Fill 方法将建立一个 AutoIncrement 属性设置为 true 的 DataColumn。不过，您将须要手动设置 AutoIncrementStep 和 AutoIncrementSeed 值。有关自动递增列的更多信息，请参阅建立 AutoIncrement 列。 当使用 FillSchema 或将 MissingSchemaAction 设置为 AddWithKey 时，将须要在数据源中进行额外的处理来肯定主键列信息。这一额外的处理可能会下降性能。若是主键信息在设计时已知，为了实现最佳性能，建议显式指定一个或多个主键列。有关为表显式设置主键信息的信息，请参阅为表定义主键。

如下代码示例显示如何使用 FillSchema 向 DataSet 添加架构信息。

[Visual Basic] Dim custDS As DataSet = New DataSet()

custDA.FillSchema(custDS, SchemaType.Source, "Customers") custDA.Fill(custDS, "Customers")

[C#] DataSet custDS = new DataSet();

custDA.FillSchema(custDS, SchemaType.Source, "Customers"); custDA.Fill(custDS, "Customers");

如下代码示例显示如何使用 Fill 方法的 MissingSchemaAction.AddWithKey 属性向 DataSet 添加架构信息。

[Visual Basic] Dim custDS As DataSet = New DataSet()

custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey custDA.Fill(custDS, "Customers")

[C#] DataSet custDS = new DataSet();

custDA.MissingSchemaAction = MissingSchemaAction.AddWithKey; custDA.Fill(custDS, "Customers");

多个结果集

若是 DataAdapter 遇到从 SelectCommand 中返回的多个结果集，它将在 DataSet 中建立多个表。将向这些表提供递增的默认名称 TableN，以表示 Table0 的“Table”为第一个表名。若是以参数形式向 FillSchema 方法传递表名称，则将向这些表提供递增的默认名称 TableNameN，这些表名称以表示 TableName0 的“TableName”为起始。

注意 若是对返回多个结果集的命令调用 OleDbDataAdapter 对象的 FillSchema 方法，则将只返回第一个结果集中的架构信息。当使用 OleDbDataAdapter 为多个结果集返回架构信息时，建议在调用 Fill 方法时将 MissingSchemaAction 指定为 AddWithKey 并获取架构信息。