DataAdapter.Fill Méthode

Définition

Espace de noms:

System.Data.Common

Assemblys:

netstandard.dll, System.Data.Common.dll

Ajoute ou actualise des lignes dans la DataSet source de données pour les mettre en correspondance.

Surcharges

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

Fill(DataSet)

Source:

DataAdapter.cs

Ajoute ou actualise des lignes dans la DataSet source de données pour les mettre en correspondance.

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, si nécessaire, schéma.

Retours

Int32

Nombre de lignes ajoutées ou actualisées dans le DataSet. Cela n’inclut pas les lignes affectées par les instructions qui ne retournent pas de lignes.

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 le DataSet, 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 AddWithKeysur , 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 résolues correctement. 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 », et ainsi de suite. Si les données entrantes contiennent des colonnes sans nom, elles sont placées dans le DataSet modèle « Column1 », « Column2 », et ainsi de suite. Lorsque plusieurs jeux de résultats sont ajoutés à chaque DataSet 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 utilisant 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 les DataSet résultats renvoie plusieurs résultats, tels qu’une instruction SQL batch, si l’un des résultats contient une erreur, tous les résultats suivants sont ignorés et non ajoutés au DataSetfichier .

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

Note

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

Voir aussi

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

Fill(DataTable, IDataReader)

Source:

DataAdapter.cs

Ajoute ou actualise des lignes dans le DataTable pour qu’elles correspondent à celles de la source de données à l’aide du DataTable nom et de l’élément spécifié 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

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 ajoutées ou actualisées dans le DataTable. Cela n’inclut pas les lignes affectées par les instructions qui ne retournent pas de lignes.

Remarques

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

Voir aussi

• Vue d'ensemble d’ADO.NET

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

Source:

DataAdapter.cs

Ajoute ou actualise des lignes dans une plage spécifiée dans la collection d’objets pour les mettre en correspondance dans la source de DataTable 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 de départ.

maxRecords

Int32

Entier indiquant le nombre maximal d’enregistrements.

Retours

Int32

Nombre de lignes ajoutées ou actualisées dans le DataTable. Cela n’inclut pas les lignes affectées par les instructions qui ne retournent pas de lignes.

Remarques

Pour plus d’informations, consultez les remarques 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 dans la DataSet plage pour qu’elles correspondent à celles de la source de données à l’aide des noms et DataTable des DataSet noms.

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 de départ.

maxRecords

Int32

Entier indiquant le nombre maximal d’enregistrements.

Retours

Int32

Nombre de lignes ajoutées ou actualisées dans le DataSet. Cela n’inclut pas les lignes affectées par les instructions qui ne retournent pas de lignes.

Remarques

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

Voir aussi

• Vue d'ensemble d’ADO.NET