DataRow, classe

Les 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 Adding Data to a 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 Deleting a Row from a Table.

L'exemple suivant crée un nouveau DataRow en appelant la méthode NewRow de l'objet DataTable.

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;
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Ce type est sécurisé pour les opérations de lecture multithread. Vous devez synchroniser les opérations d'écriture.

Référence

Autres ressources