Adds a System.Data.DataTable named "Table" to the specified System.Data.DataSet and configures the schema to match that in the data source based on the specified System.Data.SchemaType.
- dataSet
- The System.Data.DataSet to be filled with the schema from the data source.
- schemaType
- One of the System.Data.SchemaType values.
An array of System.Data.DataTable objects that contain schema information returned from the data source.
The IDataAdapter.FillSchema(DataSet, SchemaType) method retrieves the schema from the data source using the IDbDataAdapter.SelectCommand. The connection object associated with the IDbDataAdapter.SelectCommand must be valid, but it does not need to be open. If the connection is closed before IDataAdapter.FillSchema(DataSet, SchemaType) is called, it is opened to retrieve data, then closed. If the connection is open before IDataAdapter.FillSchema(DataSet, SchemaType) is called, it remains open.
A IDataAdapter.FillSchema(DataSet, SchemaType) operation adds a System.Data.DataTable to the destination System.Data.DataSet. It then adds columns to the System.Data.DataColumnCollection of the System.Data.DataTable and configures the following System.Data.DataColumn properties if they exist at the data source:
DataColumn.AutoIncrement. You must set DataColumn.AutoIncrementStep and DataColumn.AutoIncrementSeed separately.
IDataAdapter.FillSchema(DataSet, SchemaType) also configures the DataTable.PrimaryKey and DataTable.Constraints properties according to the following rules:
If one or more primary key columns are returned by the IDbDataAdapter.SelectCommand, they are used as the primary key columns for the System.Data.DataTable.
If no primary key columns are returned but unique columns are, the unique columns are used as the primary key if all the unique columns are non-nullable. If any of the columns are nullable, a System.Data.UniqueConstraint is added to the System.Data.ConstraintCollection, but the DataTable.PrimaryKey property is not set.
If both primary key columns and unique columns are returned, the primary key columns are used as the primary key columns for the System.Data.DataTable.
Note that primary keys and unique constraints are added to the System.Data.ConstraintCollection according to the previous rules, but other constraint types are not added.
If a unique clustered index is defined on a column or columns in a SQL Server table and the primary key constraint is defined on a separate set of columns, then the names of the columns in the clustered index will be returned. To return the name or names of the primary key columns, use a query hint with the SELECT statement that specifies the name of the primary key index. For more information about how to specify query hints, see tp://msdn.microsoft.com/library/ms181714.aspx.
If the System.Data.IDataAdapter encounters duplicate columns while populating a System.Data.DataTable, it generates names for the successive columns, using the pattern "columnname1", "columnname2", "columnname3", and so on. If the incoming data contains unnamed columns, they are put in the System.Data.DataSet according to the pattern "Column1", "Column2", and so on. When multiple result sets are added to the System.Data.DataSet, each result set is put in a separate table. Additional result sets are named by appending integral values to the specified table name (for example, "Table", "Table1", "Table2", and so on). Applications should use caution when using column and table names to ensure that conflicts with these naming patterns do not occur.
IDataAdapter.FillSchema(DataSet, SchemaType) returns no rows. Use the IDataAdapter.Fill(DataSet) method to add rows to a System.Data.DataTable.