DataRow Classe

Définition

public ref class DataRow

public class DataRow

[System.Serializable]
public class DataRow

type DataRow = class

[<System.Serializable>]
type DataRow = class

Public Class DataRow

Héritage

Object

DataRow

Attributs

SerializableAttribute

Exemples

L’exemple suivant crée un nouveau DataRow en appelant la NewRow méthode 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;
}

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 New DataTable("Names") 

    ' Add three column objects to the table.
    Dim idColumn As New DataColumn()
    idColumn.DataType = System.Type.GetType("System.Int32")
    idColumn.ColumnName = "id"
    idColumn.AutoIncrement = True
    namesTable.Columns.Add(idColumn)

    Dim fNameColumn As New DataColumn()
    fNameColumn.DataType = System.Type.GetType("System.String")
    fNameColumn.ColumnName = "Fname"
    fNameColumn.DefaultValue = "Fname"
    namesTable.Columns.Add(fNameColumn)

    Dim lNameColumn As 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

Remarques

Les DataRow objets et DataColumn sont les composants principaux d’un DataTable. Utilisez l’objet DataRow et ses propriétés et méthodes pour récupérer et évaluer , puis insérer, supprimer et mettre à jour les valeurs dans .DataTable représente DataRowCollection les objets réels DataRow dans le DataTable, et contient DataColumnCollection les DataColumn objets qui décrivent le schéma du DataTable. Utilisez la propriété surchargée Item[] pour renvoyer ou définir la valeur d’un DataColumn.

Utilisez les HasVersion propriétés et IsNull pour déterminer le status d’une valeur de ligne particulière, et la RowState propriété pour déterminer l’état de la ligne par rapport à son parent DataTable.

Pour créer un nouveau DataRow, utilisez la NewRow méthode de l’objet DataTable . Après avoir créé un , DataRowutilisez la Add méthode pour ajouter le nouveau DataRow au DataRowCollection. Enfin, appelez la AcceptChanges méthode de l’objet DataTable pour confirmer l’ajout. Pour plus d’informations sur l’ajout de données à un DataTable, consultez Ajout de données à un DataTable.

Vous pouvez supprimer un DataRow du en DataRowCollection appelant la Remove méthode du DataRowCollection, ou en appelant la Delete méthode de l’objet DataRow . La Remove méthode supprime la ligne de la collection. En revanche, Delete marque pour la DataRow suppression. La suppression réelle se produit lorsque vous appelez AcceptChanges la méthode. En appelant Delete, vous pouvez case activée par programmation quelles lignes sont marquées pour suppression avant de les supprimer. Pour plus d’informations, consultez Suppression de DataRow.

Constructeurs

Propriétés

Méthodes

Méthodes d’extension

S’applique à

Cohérence de thread

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

Voir aussi

• AcceptChanges()
• Add(DataRow)
• DataColumnCollection
• DataColumn
• DataRowView
• DataTable
• HasVersion(DataRowVersion)
• IsNull(Int32)
• Item[Int32]
• NewRow()
• DataRowCollection
• Utilisation de DataSets dans ADO.NET