向数据集添加现有约束 (ADO.NET)

DataAdapterFill 方法仅使用数据源中的表列和表行来填充 DataSet;虽然约束通常由数据源来设置,但在默认情况下,Fill 方法不会将此架构信息添加到 DataSet 中。 若要使用数据源中的现有主键约束信息填充 DataSet,则可以调用 DataAdapterFillSchema 方法,或者在调用 Fill 之前将 DataAdapterMissingSchemaAction 属性设置为 AddWithKey。 这将确保 DataSet 中的主键约束反映数据源中的主键约束。 外键约束信息不包含在内,必须显式创建,如数据表约束 (ADO.NET)中所示。

如果在使用数据填充 DataSet 之前向其中添加架构信息,可以确保将主键约束与 DataSet 中的 DataTable 对象包含在一起。 这样,当再次调用来填充 DataSet 时,将使用主键列信息将数据源中的新行与每个 DataTable 中的当前行相匹配,并使用数据源中的数据改写表中的当前数据。 如果没有架构信息,来自数据源的新行将追加到 DataSet 中,从而导致重复的行。

注意注意

如果数据源中的某列被标识为自动递增列,则 FillSchema 方法或 MissingSchemaActionAddWithKeyFill 方法将创建一个 AutoIncrement 属性设置为 true 的 DataColumn。不过,您将需要手动设置 AutoIncrementStepAutoIncrementSeed 值。有关自动递增列的更多信息,请参见创建 AutoIncrement 列 (ADO.NET)

当使用 FillSchema 或将 MissingSchemaAction 设置为 AddWithKey 时,将需要在数据源中进行额外的处理来确定主键列信息。 这一额外的处理可能会降低性能。 如果主键信息在设计时已知,为了实现最佳性能,建议显式指定一个或多个主键列。 有关显式设置表的主键信息的详情,请参见定义主键 (ADO.NET)

以下代码示例显示如何使用 FillSchemaDataSet 添加架构信息。

Dim custDataSet As DataSet = New DataSet()

custAdapter.FillSchema(custDataSet, SchemaType.Source, "Customers")
custAdapter.Fill(custDataSet, "Customers")
DataSet custDataSet = new DataSet();

custAdapter.FillSchema(custDataSet, SchemaType.Source, "Customers");
custAdapter.Fill(custDataSet, "Customers");

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

Dim custDataSet As DataSet = New DataSet()

custAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey
custAdapter.Fill(custDataSet, "Customers")
DataSet custDataSet = new DataSet();

custAdapter.MissingSchemaAction = MissingSchemaAction.AddWithKey;
custAdapter.Fill(custDataSet, "Customers");

处理多个结果集

如果 DataAdapter 遇到从 SelectCommand 中返回的多个结果集,将在 DataSet 中创建多个表。 将向这些表提供基于零的递增的默认名称 TableN,从 Table 开始,而不是从“Table0”开始。 如果以参数形式向 FillSchema 方法传递表名称,则将向这些表提供基于零的递增的名称 TableNameN,从 TableName 开始,而不是从“TableName0”开始。

注意注意

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

请参见

其他资源

DataAdapter 和 DataReader (ADO.NET)

DataSet、DataTable 和 DataView (ADO.NET)

在 ADO.NET 中检索和修改数据