Assembly : System.Data (dans system.data.dll)
SyntaxePublic Class DataRow
Dim instance As DataRow
public class DataRow
public ref class DataRow
public class DataRow
public class DataRow
NotesLes objets DataRow et DataColumn sont les principaux composants de DataTable. Utilisez l'objet DataRow ainsi que ses propriétés et méthodes pour récupérer, évaluer, insérer, supprimer et mettre à jour les valeurs de DataTable. DataRowCollection représente les objets DataRow réels de DataTable, et DataColumnCollection contient les objets DataColumn qui décrivent le schéma de DataTable. Utilisez la propriété Item surchargée pour retourner ou définir la valeur de DataColumn.
Utilisez les propriétés HasVersion et IsNull pour déterminer l'état d'une valeur de ligne particulière, ainsi que la propriété RowState pour déterminer l'état de la ligne par rapport à son DataTable parent.
Pour créer un nouveau DataRow, utilisez la méthode NewRow de l'objet DataTable. Lorsque vous avez créé un nouveau DataRow, utilisez la méthode Add pour ajouter le nouveau DataRow à DataRowCollection. Pour terminer, appelez la méthode AcceptChanges de l'objet DataTable pour confirmer l'ajout. Pour plus d'informations sur l'ajout de données à DataTable, consultez Ajout de données à une table.
Vous pouvez supprimer DataRow de DataRowCollection en appelant la méthode Remove de DataRowCollection ou la méthode Delete de l'objet DataRow. La méthode Remove supprime la ligne de la collection. Par contre, Delete marque DataRow en vue de sa suppression. La suppression se produit effectivement lorsque vous appelez la méthode AcceptChanges. En appelant Delete, vous pouvez vérifier par programme les lignes qui sont marquées en vue de leur suppression avant de les supprimer réellement. Pour plus d'informations, consultez Suppression d'une ligne d'une table.
ExempleL'exemple suivant crée un nouveau DataRow en appelant la méthode NewRow de l'objet DataTable.
Private Sub CreateNewDataRow() ' Use the MakeTable function below to create a new table. Dim table As DataTable table = MakeNamesTable() ' Once a table has been created, use the ' NewRow to create a DataRow. Dim row As DataRow row = table.NewRow() ' Then add the new row to the collection. row("fName") = "John" row("lName") = "Smith" table.Rows.Add(row) Dim column As DataColumn For Each column in table.Columns Console.WriteLine(column.ColumnName) Next DataGrid1.DataSource=table End Sub Private Function MakeNamesTable() As DataTable ' Create a new DataTable titled 'Names.' Dim namesTable As DataTable = new DataTable("Names") ' Add three column objects to the table. Dim idColumn As DataColumn = new DataColumn() idColumn.DataType = System.Type.GetType("System.Int32") idColumn.ColumnName = "id" idColumn.AutoIncrement = True namesTable.Columns.Add(idColumn) Dim fNameColumn As DataColumn = New DataColumn() fNameColumn.DataType = System.Type.GetType("System.String") fNameColumn.ColumnName = "Fname" fNameColumn.DefaultValue = "Fname" namesTable.Columns.Add(fNameColumn) Dim lNameColumn As DataColumn = new DataColumn() lNameColumn.DataType = System.Type.GetType("System.String") lNameColumn.ColumnName = "LName" namesTable.Columns.Add(lNameColumn) ' Create an array for DataColumn objects. Dim keys(0) As DataColumn keys(0) = idColumn namesTable.PrimaryKey = keys ' Return the new DataTable. MakeNamesTable = namesTable End Function
private void CreateNewDataRow() { // Use the MakeTable function below to create a new table. DataTable table; table = MakeNamesTable(); // Once a table has been created, use the // NewRow to create a DataRow. DataRow row; row = table.NewRow(); // Then add the new row to the collection. row["fName"] = "John"; row["lName"] = "Smith"; table.Rows.Add(row); foreach(DataColumn column in table.Columns) Console.WriteLine(column.ColumnName); dataGrid1.DataSource=table; } private DataTable MakeNamesTable() { // Create a new DataTable titled 'Names.' DataTable namesTable = new DataTable("Names"); // Add three column objects to the table. DataColumn idColumn = new DataColumn(); idColumn.DataType = System.Type.GetType("System.Int32"); idColumn.ColumnName = "id"; idColumn.AutoIncrement = true; namesTable.Columns.Add(idColumn); DataColumn fNameColumn = new DataColumn(); fNameColumn.DataType = System.Type.GetType("System.String"); fNameColumn.ColumnName = "Fname"; fNameColumn.DefaultValue = "Fname"; namesTable.Columns.Add(fNameColumn); DataColumn lNameColumn = new DataColumn(); lNameColumn.DataType = System.Type.GetType("System.String"); lNameColumn.ColumnName = "LName"; namesTable.Columns.Add(lNameColumn); // Create an array for DataColumn objects. DataColumn [] keys = new DataColumn [1]; keys[0] = idColumn; namesTable.PrimaryKey = keys; // Return the new DataTable. return namesTable; }
Sécurité des threadsCe type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser les opérations d'écriture.
Plates-formesWindows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
Informations de version
Outils (masquer)
S'enregistrer
Liste des Membres
Qui est en ligne?
FAQ