DataAdapter.FillSchema Method

Definition

Ajoute DataTable au DataSet spécifié.Adds a DataTable to the specified DataSet.

Overloads

FillSchema(DataSet, SchemaType, String, IDataReader)

Ajoute DataTable au DataSet spécifié.Adds a DataTable to the specified DataSet.

FillSchema(DataSet, SchemaType)

Ajoute un DataTable au DataSet spécifié et configure le schéma pour qu’il corresponde à celui de la source de données en fonction du SchemaTypespécifiés.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

FillSchema(DataTable, SchemaType, IDataReader)

Ajoute DataTable au DataSet spécifié.Adds a DataTable to the specified DataSet.

FillSchema(DataSet, SchemaType, String, IDataReader)

Ajoute DataTable au DataSet spécifié.Adds a DataTable to the specified DataSet.

protected:
 virtual cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType, System::String ^ srcTable, System::Data::IDataReader ^ dataReader);
protected virtual System.Data.DataTable[] FillSchema (System.Data.DataSet dataSet, System.Data.SchemaType schemaType, string srcTable, System.Data.IDataReader dataReader);
abstract member FillSchema : System.Data.DataSet * System.Data.SchemaType * string * System.Data.IDataReader -> System.Data.DataTable[]
override this.FillSchema : System.Data.DataSet * System.Data.SchemaType * string * System.Data.IDataReader -> System.Data.DataTable[]
Protected Overridable Function FillSchema (dataSet As DataSet, schemaType As SchemaType, srcTable As String, dataReader As IDataReader) As DataTable()

Parameters

dataSet
DataSet

DataTable à remplir depuis IDataReader.The DataTable to be filled from the IDataReader.

schemaType
SchemaType

Une des valeurs SchemaType.One of the SchemaType values.

srcTable
String

Le nom de la table source à utiliser pour le mappage de table.The name of the source table to use for table mapping.

dataReader
IDataReader

IDataReader à utiliser comme source de données lors du remplissage du DataTable.The IDataReader to be used as the data source when filling the DataTable.

Returns

DataTable[]

Référence à une collection d’objets DataTable qui ont été ajoutés à DataSet.A reference to a collection of DataTable objects that were added to the DataSet.

See also

FillSchema(DataSet, SchemaType)

Ajoute un DataTable au DataSet spécifié et configure le schéma pour qu’il corresponde à celui de la source de données en fonction du SchemaTypespécifiés.Adds a DataTable to the specified DataSet and configures the schema to match that in the data source based on the specified SchemaType.

public:
 virtual cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType);
public:
 abstract cli::array <System::Data::DataTable ^> ^ FillSchema(System::Data::DataSet ^ dataSet, System::Data::SchemaType schemaType);
public virtual System.Data.DataTable[] FillSchema (System.Data.DataSet dataSet, System.Data.SchemaType schemaType);
public abstract System.Data.DataTable[] FillSchema (System.Data.DataSet dataSet, System.Data.SchemaType schemaType);
abstract member FillSchema : System.Data.DataSet * System.Data.SchemaType -> System.Data.DataTable[]
override this.FillSchema : System.Data.DataSet * System.Data.SchemaType -> System.Data.DataTable[]
abstract member FillSchema : System.Data.DataSet * System.Data.SchemaType -> System.Data.DataTable[]
Public Overridable Function FillSchema (dataSet As DataSet, schemaType As SchemaType) As DataTable()
Public MustOverride Function FillSchema (dataSet As DataSet, schemaType As SchemaType) As DataTable()

Parameters

dataSet
DataSet

DataSet à remplir avec le schéma à partir de la source de données.The DataSet to be filled with the schema from the data source.

schemaType
SchemaType

Une des valeurs SchemaType.One of the SchemaType values.

Returns

DataTable[]

Objet DataTable qui contient les informations de schéma retournées par la source de données.A DataTable object that contains schema information returned from the data source.

Implements

Remarks

La méthode FillSchema récupère le schéma à partir de la source de données à l’aide du SelectCommand.The FillSchema method retrieves the schema from the data source using the SelectCommand. L’objet de connexion associé à l' SelectCommand doit être valide, mais il n’a pas besoin d’être ouvert.The connection object associated with the SelectCommand must be valid, but it does not need to be open. Si la connexion est fermée avant l’appel de FillSchema, elle est ouverte pour récupérer les données, puis fermée.If the connection is closed before FillSchema is called, it is opened to retrieve data and then closed. Si la connexion est ouverte avant l’appel de FillSchema, elle reste ouverte.If the connection is open before FillSchema is called, it remains open.

Une opération FillSchema ajoute un DataTable à l' DataSetde destination.A FillSchema operation adds a DataTable to the destination DataSet. Il ajoute ensuite des colonnes au DataColumnCollection du DataTableet configure les propriétés de DataColumn suivantes si elles existent dans la source de données :It then adds columns to the DataColumnCollection of the DataTable, and configures the following DataColumn properties if they exist at the data source:

FillSchema configure également les propriétés de PrimaryKey et de Constraints en fonction des règles suivantes :FillSchema also configures the PrimaryKey and Constraints properties according to the following rules:

  • Si une ou plusieurs colonnes clés primaires sont retournées par la SelectCommand, elles sont utilisées comme colonnes clés primaires pour le DataTable.If one or more primary key columns are returned by the SelectCommand, they are used as the primary key columns for the DataTable.

  • Si aucune colonne de clé primaire n’est retournée, mais que les colonnes uniques sont, les colonnes uniques sont utilisées comme clé primaire si, et uniquement si, toutes les colonnes uniques ne sont pas nulles.If no primary key columns are returned but unique columns are, the unique columns are used as the primary key if, and only if, all the unique columns are nonnullable. Si l’une des colonnes accepte la valeur null, une UniqueConstraint est ajoutée au ConstraintCollection, mais la propriété PrimaryKey n’est pas définie.If any of the columns are nullable, a UniqueConstraint is added to the ConstraintCollection, but the PrimaryKey property is not set.

  • Si les colonnes de clé primaire et les colonnes uniques sont retournées, les colonnes de clé primaire sont utilisées comme colonnes de clé primaire pour le DataTable.If both primary key columns and unique columns are returned, the primary key columns are used as the primary key columns for the DataTable.

Note

Le magasin de données sous-jacent peut autoriser des attributs de colonne qui ne sont pas pris en charge dans un DataColumn, ce qui entraîne le non-fonctionnement correct de certains attributs de colonne.The underlying data store may allow column attributes that are not supported in a DataColumn, which causes some column attributes to not translate correctly. Par exemple, SQL Server autorise une colonne d’identité avec un type de données tinyint alors qu’une DataColumn autorise uniquement Int16, Int32 et Int64 à avoir la propriété AutoIncrement définie.For example, SQL Server allows an identity column with a data type of tinyint whereas a DataColumn only allows Int16, Int32, and Int64 to have the AutoIncrement property set. FillSchema ignore silencieusement les cas où l' DataColumn ne peut pas mettre en miroir avec précision la source de données et ne lève aucune exception.FillSchema silently ignores cases where the DataColumn cannot accurately mirror the data source and throws no exception.

Notez que les clés primaires et les contraintes uniques sont ajoutées au ConstraintCollection selon les règles précédentes, mais que d’autres types de contraintes ne sont pas ajoutés.Note that primary keys and unique constraints are added to the ConstraintCollection according to the preceding rules, but other constraint types are not added.

Si un index cluster unique est défini sur une ou plusieurs colonnes d’une table SQL Server et que la contrainte de clé primaire est définie sur un ensemble distinct de colonnes, les noms des colonnes dans l’index cluster sont retournés.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. Pour retourner le nom ou les noms des colonnes de clé primaire, utilisez un indicateur de requête avec l’instruction SELECT qui spécifie le nom de l’index de clé primaire.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. Pour plus d’informations sur la spécification des indicateurs de requête, consultez indicateurs (Transact-SQL)-requête.For more information about specifying query hints, see Hints (Transact-SQL) - Query.

Si le DataAdapter rencontre des colonnes dupliquées lors du remplissage d’un DataTable, il génère des noms pour les colonnes suivantes, à l’aide du modèle «ColumnName1 », «ColumnName2 », «ColumnName3 », et ainsi de suite.If the DataAdapter encounters duplicate columns while populating a DataTable, it generates names for the subsequent columns, using the pattern "columnname1", "columnname2", "columnname3", and so on. Si les données entrantes contiennent des colonnes sans nom, elles sont placées dans le DataSet en fonction du modèle « Column1 », « Column2 », etc.If the incoming data contains unnamed columns, they are placed in the DataSet according to the pattern "Column1", "Column2", and so on. Lorsque plusieurs jeux de résultats sont ajoutés au DataSet chaque jeu de résultats est placé dans une table distincte.When multiple result sets are added to the DataSet each result set is placed in a separate table. Les jeux de résultats supplémentaires sont nommés en ajoutant des valeurs intégrales au nom de table spécifié (par exemple, « table », « Table1 », « Table2 », etc.).Additional result sets are named by appending integral values to the specified table name (for example, "Table", "Table1", "Table2", and so on). Les applications qui utilisent des noms de colonnes et de tables doivent s’assurer que les conflits avec ces modèles de nommage ne se produisent pas.Applications using column and table names should ensure that conflicts with these naming patterns does not occur.

FillSchema ne retourne pas de lignes.FillSchema does not return any rows. Utilisez la méthode Fill pour ajouter des lignes à une DataTable.Use the Fill method to add rows to a DataTable.

Note

Lors du traitement d’instructions SQL par lots qui retournent plusieurs résultats, l’implémentation de FillSchema pour l' .NET Framework Fournisseur de données pour OLE DB récupère les informations de schéma uniquement pour le premier résultat.When handling batch SQL statements that return multiple results, the implementation of FillSchema for the .NET Framework Data Provider for OLE DB retrieves schema information for only the first result. Pour récupérer des informations de schéma pour plusieurs résultats, utilisez Fill avec la MissingSchemaAction définie sur AddWithKey.To retrieve schema information for multiple results, use Fill with the MissingSchemaAction set to AddWithKey.

See also

FillSchema(DataTable, SchemaType, IDataReader)

Ajoute DataTable au DataSet spécifié.Adds a DataTable to the specified DataSet.

protected:
 virtual System::Data::DataTable ^ FillSchema(System::Data::DataTable ^ dataTable, System::Data::SchemaType schemaType, System::Data::IDataReader ^ dataReader);
protected virtual System.Data.DataTable FillSchema (System.Data.DataTable dataTable, System.Data.SchemaType schemaType, System.Data.IDataReader dataReader);
abstract member FillSchema : System.Data.DataTable * System.Data.SchemaType * System.Data.IDataReader -> System.Data.DataTable
override this.FillSchema : System.Data.DataTable * System.Data.SchemaType * System.Data.IDataReader -> System.Data.DataTable
Protected Overridable Function FillSchema (dataTable As DataTable, schemaType As SchemaType, dataReader As IDataReader) As DataTable

Parameters

dataTable
DataTable

DataTable à remplir depuis IDataReader.The DataTable to be filled from the IDataReader.

schemaType
SchemaType

Une des valeurs SchemaType.One of the SchemaType values.

dataReader
IDataReader

IDataReader à utiliser comme source de données lors du remplissage du DataTable.The IDataReader to be used as the data source when filling the DataTable.

Returns

DataTable

Objet DataTable qui contient les informations de schéma retournées par la source de données.A DataTable object that contains schema information returned from the data source.

See also

Applies to