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 并获取架构信息。