语言

IDataAdapter.FillSchema(DataSet, SchemaType) 方法

定义

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

public:
 cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType);
[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")]
public 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);
[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("IDataReader's (built from adapter commands) schema table types cannot be statically analyzed.")>]
abstract member FillSchema : System.Data.DataSet * System.Data.SchemaType -> System.Data.DataTable[]
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 。

特性

注解

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

操作 FillSchema 将添加到 DataTable 目标 DataSet。 然后,它将列添加到 DataColumnCollection 其中 DataTable ,并配置以下 DataColumn 属性(如果它们存在于数据源中):

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

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

  • 如果没有返回主键列,但唯一列是,如果所有唯一列不可为 null,则唯一列将用作主键。 如果任一列可为 null,则会向UniqueConstraint其中添加一个ConstraintCollection列,但未设置该PrimaryKey属性。

  • 如果返回主键列和唯一列,则主键列将用作主键列。DataTable

请注意,主键和唯一约束将添加到 ConstraintCollection 上述规则中,但不会添加其他约束类型。

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

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

FillSchema 不返回任何行。 Fill使用该方法向 a DataTable添加行。

适用于

另请参阅