DataRowCollection.Add Méthode

public:
 void Add(System::Data::DataRow ^ row);

public void Add(System.Data.DataRow row);

member this.Add : System.Data.DataRow -> unit

Public Sub Add (row As DataRow)

Paramètres

Exceptions

Exemples

L’exemple suivant utilise la Add méthode pour ajouter un nouvel DataRow objet DataRowCollection .

private void ShowRows(DataTable table)
{
    // Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count);
    // Print the value of columns 1 in each row
    foreach(DataRow row in table.Rows)
    {
        Console.WriteLine(row[1]);
    }
}

private void AddRow(DataTable table)
{
    DataRowCollection rowCollection = table.Rows;
    // Instantiate a new row using the NewRow method.

    DataRow newRow = table.NewRow();
    // Insert code to fill the row with values.

    // Add the row to the DataRowCollection.
    table.Rows.Add(newRow);
}

Private Sub ShowRows(Byval table As DataTable)
    ' Print the number of rows in the collection.
    Console.WriteLine(table.Rows.Count)

    Dim row  As DataRow
    ' Print the value of columns 1 in each row
    For Each row In table.Rows
        Console.WriteLine(row(1))
    Next
End Sub
 
Private Sub AddRow(ByVal table As DataTable)
    ' Instantiate a new row using the NewRow method.
    Dim newRow As DataRow = table.NewRow()
    ' Insert code to fill the row with values.

    ' Add the row to the DataRowCollection.
    table.Rows.Add(newRow)
End Sub

Remarques

Pour créer un DataRownouveau, vous devez utiliser la NewRow méthode de la DataTable classe. Lorsque vous utilisez la NewRow méthode, un nouvel DataRow objet est retourné à l’aide du schéma du parent DataTable. Après avoir créé l’objet DataRow et défini les valeurs de chacune de ses colonnes, utilisez la Add méthode pour ajouter l’objet à la collection.

Génère une exception si l’utilisateur génère une exception dans l’événement RowChanging . Si une exception se produit, la ligne n’est pas ajoutée à la table.

Voir aussi

• Clear()
• DataTable
• DataRow
• NewRow()
• Remove(DataRow)

public:
 virtual System::Data::DataRow ^ Add(cli::array <System::Object ^> ^ values);

public:
 System::Data::DataRow ^ Add(... cli::array <System::Object ^> ^ values);

public virtual System.Data.DataRow Add(object[] values);

public System.Data.DataRow Add(params object[] values);

abstract member Add : obj[] -> System.Data.DataRow
override this.Add : obj[] -> System.Data.DataRow

member this.Add : obj[] -> System.Data.DataRow

Public Overridable Function Add (values As Object()) As DataRow

Public Function Add (ParamArray values As Object()) As DataRow

Paramètres

Retours

Nouvelle ligne.

Exceptions

Exemples

L’exemple suivant utilise la Add méthode pour créer et ajouter un nouvel DataRow objet à un DataRowCollection.

private void AddRow(DataTable table)
{
    // Create an array with three elements.
    object[] rowVals = new object[3];
    DataRowCollection rowCollection = table.Rows;
    rowVals[0] = "hello";
    rowVals[1] = "world";
    rowVals[2] = "two";

    // Add and return the new row.
    DataRow row = rowCollection.Add(rowVals);
}

Private Sub AddRow(ByVal table As DataTable)
    ' Create an array with three elements.
    Dim rowVals(2) As Object
    Dim rowCollection As DataRowCollection = table.Rows
    rowVals(0) = "hello"
    rowVals(1) = "world"
    rowVals(2) = "two"

    ' Add and return the new row.
    Dim row As DataRow = rowCollection.Add(rowVals) 
End Sub

Remarques

Si un DataColumn objet a la AutoIncrement valeur True, la valeur Null doit être transmise pour obtenir la valeur par défaut de cette colonne.

Les exceptions peuvent également se produire si vous générez une exception pendant un ou RowChanging un ColumnChanging événement. Si une exception se produit, la ligne n’est pas ajoutée à la table.

Voir aussi

• Clear()
• DataTable
• DataRow
• NewRow()
• Remove(DataRow)