DataAdapter.Fill Méthode

Définition

Espace de noms:

System.Data.Common

Assembly:

System.Data.Common.dll

Ajoute ou actualise les lignes de DataSet pour qu'elles correspondent à celles de la source de données.

Surcharges

Fill(DataSet)	Ajoute ou actualise les lignes de DataSet pour qu'elles correspondent à celles de la source de données.
Fill(DataTable, IDataReader)	Ajoute ou actualise les lignes de DataTable pour établir une correspondance avec celles de la source de données à l'aide du nom DataTable et du IDataReader spécifié.
Fill(DataTable[], IDataReader, Int32, Int32)	Ajoute ou actualise des lignes d'une plage spécifiée de la collection d'objets DataTable pour qu'elles correspondent à celles de la source de données.
Fill(DataSet, String, IDataReader, Int32, Int32)	Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable.

Fill(DataSet)

Source:

DataAdapter.cs

Ajoute ou actualise les lignes de DataSet pour qu'elles correspondent à celles de la source de données.

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

Public Overridable Function Fill (dataSet As DataSet) As Integer

Paramètres

dataSet

DataSet

DataSet à remplir avec des enregistrements et, éventuellement, un schéma.

Retours

Int32

Nombre de lignes correctement ajoutées ou actualisées dans DataSet. Cela n'inclut pas les lignes affectées par des instructions qui ne retournent pas de ligne.

Implémente

Fill(DataSet)

Remarques

La Fill méthode récupère les lignes de la source de données à l’aide de l’instruction SELECT spécifiée par une propriété associée SelectCommand . L’objet de connexion associé à l’instruction SELECT doit être valide, mais il n’a pas besoin d’être ouvert. Si la connexion est fermée avant Fill d’être appelée, elle est ouverte pour récupérer des données, puis fermée. Si la connexion est ouverte avant Fill d’être appelée, elle reste ouverte.

L’opération Fill ajoute ensuite les lignes aux objets de destination DataTable dans , DataSeten créant les DataTable objets s’ils n’existent pas déjà. Lors de la création d’objets DataTable , l’opération Fill crée normalement uniquement des métadonnées de nom de colonne. Toutefois, si la MissingSchemaAction propriété est définie sur AddWithKey, les clés primaires et les contraintes appropriées sont également créées.

Si SelectCommand retourne les résultats d'une jointure externe, le DataAdapter ne définit pas de valeur PrimaryKey pour le DataTableobtenu. Vous devez définir explicitement la clé primaire pour vous assurer que les lignes en double sont correctement résolues. Pour plus d’informations, consultez Définition des clés primaires.

Si l’adaptateur de données rencontre des colonnes en double lors du remplissage d’un DataTable, il génère des noms pour les colonnes suivantes, à l’aide du modèle « columnname1 », « columnname2 », « columnname3 », etc. 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. Lorsque plusieurs jeux de résultats sont ajoutés au DataSet jeu de résultats, chaque jeu de résultats est placé dans une table distincte. D’autres jeux de résultats sont nommés en ajoutant des valeurs intégrales au nom de table spécifié (par exemple, « Table », « Table1 », « Table2 », etc.). Les applications qui utilisent des noms de colonnes et de tables doivent s’assurer que les conflits avec ces modèles d’affectation de noms ne se produisent pas.

Lorsque l’instruction SELECT utilisée pour remplir le DataSet retourne plusieurs résultats, tels qu’un lot d’instructions SQL, si l’un des résultats contient une erreur, tous les résultats suivants sont ignorés et non ajoutés à .DataSet

Vous pouvez utiliser la Fill méthode plusieurs fois sur le même DataTable. S’il existe une clé primaire, les lignes entrantes sont fusionnées avec les lignes correspondantes qui existent déjà. S’il n’existe aucune clé primaire, les lignes entrantes sont ajoutées à .DataTable

Notes

Lors de la gestion des instructions SQL par lot qui retournent plusieurs résultats, l’implémentation de pour le fournisseur de FillSchema données .NET Framework pour OLE DB récupère les informations de schéma uniquement pour le premier résultat. Pour récupérer des informations de schéma pour plusieurs résultats, utilisez Fill avec la MissingSchemaAction valeur définie sur AddWithKey.

Voir aussi

• FillSchema(DataSet, SchemaType)
• Vue d'ensemble d’ADO.NET

Fill(DataTable, IDataReader)

Source:

DataAdapter.cs

Ajoute ou actualise les lignes de DataTable pour établir une correspondance avec celles de la source de données à l'aide du nom DataTable et du IDataReader spécifié.

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

Protected Overridable Function Fill (dataTable As DataTable, dataReader As IDataReader) As Integer

Paramètres

dataTable

DataTable

DataTable à remplir avec des enregistrements.

dataReader

IDataReader

Instance de IDataReader.

Retours

Int32

Nombre de lignes correctement ajoutées ou actualisées dans DataTable. Cela n'inclut pas les lignes affectées par des instructions qui ne retournent pas de ligne.

Remarques

Pour plus d’informations, consultez les remarques relatives DataAdapter.Fill(DataSet) .

Voir aussi

• Vue d'ensemble d’ADO.NET

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

Source:

DataAdapter.cs

Ajoute ou actualise des lignes d'une plage spécifiée de la collection d'objets DataTable pour qu'elles correspondent à celles de la source de données.

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[]

Collection d'objets DataTable à remplir avec des enregistrements.

dataReader

IDataReader

Instance de IDataReader.

startRecord

Int32

Index de base zéro de l'enregistrement initial.

maxRecords

Int32

Entier qui indique le nombre maximal d'enregistrements.

Retours

Int32

Nombre de lignes correctement ajoutées ou actualisées dans DataTable. Cela n'inclut pas les lignes affectées par des instructions qui ne retournent pas de ligne.

Remarques

Pour plus d’informations, consultez les remarques relatives System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .

Voir aussi

• Vue d'ensemble d’ADO.NET

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

Source:

DataAdapter.cs

Ajoute ou actualise des lignes dans une plage spécifiée de DataSet pour qu'elles correspondent à celles de la source de données en utilisant les noms DataSet et DataTable.

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

Protected Overridable Function Fill (dataSet As DataSet, srcTable As String, dataReader As IDataReader, startRecord As Integer, maxRecords As Integer) As Integer

Paramètres

dataSet

DataSet

DataSet à remplir avec des enregistrements.

srcTable

String

Chaîne indiquant le nom de la table source.

dataReader

IDataReader

Instance de IDataReader.

startRecord

Int32

Index de base zéro de l'enregistrement initial.

maxRecords

Int32

Entier qui indique le nombre maximal d'enregistrements.

Retours

Int32

Nombre de lignes correctement ajoutées ou actualisées dans DataSet. Cela n'inclut pas les lignes affectées par des instructions qui ne retournent pas de ligne.

Remarques

Pour plus d’informations, consultez les remarques relatives System.Data.Common.DataAdapter.Fill(System.Data.DataSet) .

Voir aussi

• Vue d'ensemble d’ADO.NET