DataAdapter.Fill DataAdapter.Fill DataAdapter.Fill DataAdapter.Fill Method

Définition

Ajoute ou actualise des lignes dans le DataSet correspondre à ceux de la source de données.Adds or refreshes rows in the DataSet to match those in the data source.

Surcharges

Fill(DataSet) Fill(DataSet) Fill(DataSet)

Ajoute ou actualise des lignes dans le DataSet correspondre à ceux de la source de données.Adds or refreshes rows in the DataSet to match those in the data source.

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader)

Ajoute ou actualise des lignes dans le DataTable correspondre à ceux de la source de données en utilisant le DataTable spécifié et nom IDataReader.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32)

Ajoute ou actualise des lignes dans une plage spécifiée dans la collection de DataTable objets correspondent à celles de la source de données.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32)

Ajoute ou actualise des lignes dans une plage spécifiée dans le DataSet correspondre à ceux de la source de données en utilisant le DataSet et DataTable noms.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

Fill(DataSet) Fill(DataSet) Fill(DataSet)

Ajoute ou actualise des lignes dans le DataSet correspondre à ceux de la source de données.Adds or refreshes rows in the DataSet to match those in the data source.

public:
 virtual int Fill(System::Data::DataSet ^ dataSet);
public virtual int Fill (System.Data.DataSet dataSet);
abstract member Fill : System.Data.DataSet -> int
override this.Fill : System.Data.DataSet -> int

Paramètres

dataSet
DataSet DataSet DataSet DataSet

Un DataSet à remplir avec des enregistrements et, si nécessaire, schéma.A DataSet to fill with records and, if necessary, schema.

Retours

Le nombre de lignes correctement ajoutées ou actualisées dans le DataSet.The number of rows successfully added to or refreshed in the DataSet. Cela n’inclut pas de lignes affectées par les instructions qui ne retournent pas de lignes.This does not include rows affected by statements that do not return rows.

Implémente

Remarques

Le Fill méthode extrait des lignes de la source de données à l’aide de l’instruction SELECT spécifiée par associé à un SelectCommand propriété.The Fill method retrieves rows from the data source using the SELECT statement specified by an associated SelectCommand property. L’objet de connexion associé à l’instruction SELECT doit être valide, mais il ne doit-elle pas être ouverts.The connection object associated with the SELECT statement must be valid, but it does not need to be open. Si la connexion est fermée avant Fill est appelée, elle est ouverte pour récupérer les données, puis fermé.If the connection is closed before Fill is called, it is opened to retrieve data, then closed. Si la connexion est ouverte avant Fill est appelée, elle reste ouverte.If the connection is open before Fill is called, it remains open.

Le Fill opération ajoute ensuite les lignes vers la destination DataTable des objets dans le DataSet, en créant le DataTable objets si elles n’existent pas déjà.The Fill operation then adds the rows to destination DataTable objects in the DataSet, creating the DataTable objects if they do not already exist. Lors de la création DataTable objets, le Fill opération crée normalement que des métadonnées de nom de colonne.When creating DataTable objects, the Fill operation normally creates only column name metadata. Toutefois, si le MissingSchemaAction propriété est définie sur AddWithKey, clés primaires appropriés et les contraintes sont également créés.However, if the MissingSchemaAction property is set to AddWithKey, appropriate primary keys and constraints are also created.

Si SelectCommand retourne les résultats d'une jointure externe, le DataAdapter ne définit pas de valeur PrimaryKey pour le DataTableobtenu.If the SelectCommand returns the results of an OUTER JOIN, the DataAdapter does not set a PrimaryKey value for the resulting DataTable. Vous devez définir explicitement la clé primaire pour garantir une résolution correcte des lignes en double.You must explicitly define the primary key to ensure that duplicate rows are resolved correctly. Pour plus d’informations, consultez définition des clés primaires.For more information, see Defining Primary Keys.

Si l’adaptateur de données 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 data adapter 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, ils sont placés dans le DataSet selon le modèle « Column1 », « Column2 » et ainsi de suite.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 est ajoutés à la 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. 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 » et ainsi de suite).Additional result sets are named by appending integral values to the specified table name (for example, "Table", "Table1", "Table2", and so on). Applications à l’aide des noms de colonne et de table devraient vous assurer que tout conflit avec ces modèles d’affectation de noms ne se produit pas.Applications using column and table names should ensure that conflicts with these naming patterns does not occur.

Lorsque l’instruction SELECT utilisée pour remplir le DataSet retourne plusieurs résultats, tels que des instructions SQL par lots, si un des résultats contient une erreur, tous les résultats suivants sont ignorés et pas ajoutés à la DataSet.When the SELECT statement used to populate the DataSet returns multiple results, such as a batch SQL statements, if one of the results contains an error, all subsequent results are skipped and not added to the DataSet.

Vous pouvez utiliser la Fill méthode plusieurs fois sur le même DataTable.You can use the Fill method multiple times on the same DataTable. Si une clé primaire existe, les lignes entrantes sont fusionnées avec les lignes correspondantes qui existent déjà.If a primary key exists, incoming rows are merged with matching rows that already exist. Si aucune clé primaire n’existe, les lignes entrantes sont ajoutées à la DataTable.If no primary key exists, incoming rows are appended to the DataTable.

Notes

Lors du traitement d’instructions SQL par lots qui retournent plusieurs résultats, l’implémentation de FillSchema pour le fournisseur de données .NET Framework pour OLE DB récupère les informations de schéma pour seulement 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 les informations de schéma pour plusieurs résultats, utilisez Fill avec la MissingSchemaAction défini sur AddWithKey.To retrieve schema information for multiple results, use Fill with the MissingSchemaAction set to AddWithKey.

Voir aussi

Fill(DataTable, IDataReader) Fill(DataTable, IDataReader) Fill(DataTable, IDataReader)

Ajoute ou actualise des lignes dans le DataTable correspondre à ceux de la source de données en utilisant le DataTable spécifié et nom IDataReader.Adds or refreshes rows in the DataTable to match those in the data source using the DataTable name and the specified IDataReader.

protected:
 virtual int Fill(System::Data::DataTable ^ dataTable, System::Data::IDataReader ^ dataReader);
protected virtual int Fill (System.Data.DataTable dataTable, System.Data.IDataReader dataReader);
abstract member Fill : System.Data.DataTable * System.Data.IDataReader -> int
override this.Fill : System.Data.DataTable * System.Data.IDataReader -> int

Paramètres

dataTable
DataTable DataTable DataTable DataTable

Un DataTable à remplir avec des enregistrements.A DataTable to fill with records.

dataReader
IDataReader IDataReader IDataReader IDataReader

Instance de IDataReader.An instance of IDataReader.

Retours

Le nombre de lignes correctement ajoutées ou actualisées dans le DataTable.The number of rows successfully added to or refreshed in the DataTable. Cela n’inclut pas de lignes affectées par les instructions qui ne retournent pas de lignes.This does not include rows affected by statements that do not return rows.

Remarques

Consultez les notes relatives à DataAdapter.Fill(DataSet) pour plus d’informations.See the remarks for DataAdapter.Fill(DataSet) for additional information.

Voir aussi

Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32) Fill(DataTable[], IDataReader, Int32, Int32)

Ajoute ou actualise des lignes dans une plage spécifiée dans la collection de DataTable objets correspondent à celles de la source de données.Adds or refreshes rows in a specified range in the collection of DataTable objects to match those in the data source.

protected:
 virtual int Fill(cli::array <System::Data::DataTable ^> ^ dataTables, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);
protected virtual int Fill (System.Data.DataTable[] dataTables, System.Data.IDataReader dataReader, int startRecord, int maxRecords);
abstract member Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataTable[] * System.Data.IDataReader * int * int -> int
Protected Overridable Function Fill (dataTables As DataTable(), dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer

Paramètres

dataTables
DataTable[]

Une collection de DataTable objets à remplir avec des enregistrements.A collection of DataTable objects to fill with records.

dataReader
IDataReader IDataReader IDataReader IDataReader

Instance de IDataReader.An instance of IDataReader.

startRecord
Int32 Int32 Int32 Int32

Index de base zéro de l’enregistrement initial.The zero-based index of the starting record.

maxRecords
Int32 Int32 Int32 Int32

Entier indiquant le nombre maximal d’enregistrements.An integer indicating the maximum number of records.

Retours

Le nombre de lignes correctement ajoutées ou actualisées dans le DataTable.The number of rows successfully added to or refreshed in the DataTable. Cela n’inclut pas de lignes affectées par les instructions qui ne retournent pas de lignes.This does not include rows affected by statements that do not return rows.

Remarques

Consultez les notes relatives à System.Data.Common.DataAdapter.Fill(System.Data.DataSet) pour plus d’informations.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Voir aussi

Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32) Fill(DataSet, String, IDataReader, Int32, Int32)

Ajoute ou actualise des lignes dans une plage spécifiée dans le DataSet correspondre à ceux de la source de données en utilisant le DataSet et DataTable noms.Adds or refreshes rows in a specified range in the DataSet to match those in the data source using the DataSet and DataTable names.

protected:
 virtual int Fill(System::Data::DataSet ^ dataSet, System::String ^ srcTable, System::Data::IDataReader ^ dataReader, int startRecord, int maxRecords);
protected virtual int Fill (System.Data.DataSet dataSet, string srcTable, System.Data.IDataReader dataReader, int startRecord, int maxRecords);
abstract member Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int
override this.Fill : System.Data.DataSet * string * System.Data.IDataReader * int * int -> int

Paramètres

dataSet
DataSet DataSet DataSet DataSet

Un DataSet à remplir avec des enregistrements.A DataSet to fill with records.

srcTable
String String String String

Chaîne indiquant le nom de la table source.A string indicating the name of the source table.

dataReader
IDataReader IDataReader IDataReader IDataReader

Instance de IDataReader.An instance of IDataReader.

startRecord
Int32 Int32 Int32 Int32

Index de base zéro de l’enregistrement initial.The zero-based index of the starting record.

maxRecords
Int32 Int32 Int32 Int32

Entier indiquant le nombre maximal d’enregistrements.An integer indicating the maximum number of records.

Retours

Le nombre de lignes correctement ajoutées ou actualisées dans le DataSet.The number of rows successfully added to or refreshed in the DataSet. Cela n’inclut pas de lignes affectées par les instructions qui ne retournent pas de lignes.This does not include rows affected by statements that do not return rows.

Remarques

Consultez les notes relatives à System.Data.Common.DataAdapter.Fill(System.Data.DataSet) pour plus d’informations.See the remarks for System.Data.Common.DataAdapter.Fill(System.Data.DataSet) for additional information.

Voir aussi

S’applique à