IDataAdapter.FillSchema(DataSet, SchemaType) 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

将名为“Table”的 DataTable 添加到指定的 DataSet，并根据指定的 SchemaType 配置架构以匹配数据源中的架构。

public:
 cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType);

public System.Data.DataTable[] FillSchema (System.Data.DataSet dataSet, System.Data.SchemaType schemaType);

abstract member FillSchema : System.Data.DataSet * System.Data.SchemaType -> System.Data.DataTable[]

Public Function FillSchema (dataSet As DataSet, schemaType As SchemaType) As DataTable()

参数

dataSet

DataSet

要用数据源中的架构填充的 DataSet。

schemaType

SchemaType

SchemaType 值之一。

返回

DataTable[]

DataTable 对象的数组，这些对象包含从数据源返回的架构信息。

注解

方法 FillSchema 使用 SelectCommand从数据源检索架构。 与 关联的 SelectCommand 连接对象必须有效，但不需要打开。 如果在调用 之前 FillSchema 关闭了连接，则会打开该连接以检索数据，然后关闭。 如果连接在调用 之前 FillSchema 处于打开状态，它将保持打开状态。

操作 FillSchema 将 添加到 DataTable 目标 DataSet。 然后，它将列添加到 的 ，DataColumnCollectionDataTable并配置以下DataColumn属性（如果它们存在于数据源中）：

• AllowDBNull

• AutoIncrement. 必须单独设置 AutoIncrementStep 和 AutoIncrementSeed 。

• MaxLength

• ReadOnly

• Unique

FillSchema 还根据以下规则配置 PrimaryKey 和 Constraints 属性：

• 如果 一个或多个主键列由 SelectCommand返回，则它们将用作 的主键列 DataTable。

• 如果未返回主键列，但唯一列为 ，则所有唯一列不可为 null 时，将唯一列用作主键。 如果任一列可为空， UniqueConstraint 则会将 添加到 ， ConstraintCollection但 PrimaryKey 未设置 属性。

• 如果同时返回主键列和唯一列，则主键列将用作 的主键列 DataTable。

请注意，主键和唯一约束根据前面的规则添加到 ， ConstraintCollection 但不会添加其他约束类型。

如果在SQL Server表中的列上定义了唯一聚集索引，并且主键约束在一组单独的列上定义，则将返回聚集索引中列的名称。 若要返回主键列的名称，请将查询提示与 SELECT 语句结合使用，该语句指定主键索引的名称。 有关如何指定查询提示的详细信息，请参阅 Transact-SQL) - 查询 (提示。

IDataAdapter如果在填充 DataTable时遇到重复列，它将使用模式“columnname1”、“columnname2”、“columnname3”等为连续列生成名称。 如果传入数据包含未命名的列，则根据模式“Column1”、“Column2”等将其放入 DataSet 中。 将多个结果集添加到 时， DataSet每个结果集都放在单独的表中。 其他结果集通过将整型值追加到指定的表名称 (例如“Table”、“Table1”、“Table2”等) 来命名。 应用程序在使用列名和表名时应小心，以确保不会发生与这些命名模式冲突的情况。

FillSchema 不返回任何行。 Fill使用 方法将行DataTable添加到 。

另请参阅

• Fill(DataSet)