IDataAdapter.FillSchema(DataSet, SchemaType) IDataAdapter.FillSchema(DataSet, SchemaType) IDataAdapter.FillSchema(DataSet, SchemaType) Method

Définition

Ajoute un DataTable nommé « Table » au DataSet spécifié et configure le schéma pour qu’il corresponde à celui de la source de données en fonction du SchemaType spécifié.Adds a DataTable named "Table" to the specified DataSet and configures the schema to match that in the data source based on the specified 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[]

Paramètres

dataSet
DataSet 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 SchemaType SchemaType

Une des valeurs de SchemaType.One of the SchemaType values.

Retours

Tableau d'objets DataTable qui contient les informations de schéma retournées par la source de données.An array of DataTable objects that contain schema information returned from the data source.

Remarques

La FillSchema méthode récupère le schéma à partir de la source de données SelectCommandà l’aide du.The FillSchema method retrieves the schema from the data source using the SelectCommand. L’objet de connexion associé au 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 FillSchema l’appel de, 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, then closed. Si la connexion est ouverte avant FillSchema que ne soit appelée, elle reste ouverte.If the connection is open before FillSchema is called, it remains open.

Une FillSchema opération ajoute un DataTable à la destination DataSet.A FillSchema operation adds a DataTable to the destination DataSet. Il ajoute ensuite DataColumnCollection DataTable des colonnes au du et configure les propriétés suivantes DataColumn s’ils 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:

FillSchemaconfigure également les PrimaryKey propriétés et 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 SelectCommandpar le, elles sont utilisées comme colonnes clés primaires pour DataTablele.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 toutes les colonnes uniques n’acceptent pas les valeurs NULL.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. Si l’une des colonnes accepte la valeur null UniqueConstraint , un est ajouté ConstraintCollectionà, mais PrimaryKey la propriété 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 DataTablede clé primaire pour le.If both primary key columns and unique columns are returned, the primary key columns are used as the primary key columns for the DataTable.

Notez que les clés primaires et les contraintes uniques sont ajoutées ConstraintCollection à en fonction des 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 previous 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 façon de spécifier des indicateurs de requête, consultez indicateur de requête (Transact-SQL).For more information about how to specify query hints, see Query Hint (Transact-SQL).

Si le IDataAdapter rencontre des colonnes dupliquées lors du remplissage DataTabled’un, il génère des noms pour les colonnes successives, en utilisant le modèle «nomcolonne1», «nomcolonne2», «columnname3», et ainsi de suite.If the IDataAdapter encounters duplicate columns while populating a DataTable, it generates names for the successive columns, using the pattern "columnname1", "columnname2", "columnname3", and so on. Si les données entrantes contiennent des colonnes sans nom, elles sont placées DataSet dans en fonction du modèle «Column1», «Column2», et ainsi de suite.If the incoming data contains unnamed columns, they are put 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 put 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 doivent utiliser avec précaution lors de l’utilisation de noms de colonnes et de tables pour s’assurer que les conflits avec ces modèles de nom ne se produisent pas.Applications should use caution when using column and table names to ensure that conflicts with these naming patterns do not occur.

FillSchemane retourne aucune ligne.FillSchema returns no rows. Utilisez la Fill méthode pour ajouter des lignes à DataTableun.Use the Fill method to add rows to a DataTable.

S’applique à

Voir aussi