DataRowCollection.Add DataRowCollection.Add DataRowCollection.Add DataRowCollection.Add Method

Definition

Ajoute un objet DataRow à DataRowCollection. Adds a DataRow to the DataRowCollection.

Overloads

Add(DataRow) Add(DataRow) Add(DataRow) Add(DataRow)

Ajoute le DataRow spécifié à l'objet DataRowCollection. Adds the specified DataRow to the DataRowCollection object.

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

Crée une ligne à l'aide des valeurs spécifiées et l'ajoute à DataRowCollection. Creates a row using specified values and adds it to the DataRowCollection.

Add(DataRow) Add(DataRow) Add(DataRow) Add(DataRow)

Ajoute le DataRow spécifié à l'objet DataRowCollection. Adds the specified DataRow to the DataRowCollection object.

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

row
DataRow DataRow DataRow DataRow

DataRow à ajouter. The DataRow to add.

Exceptions

La ligne appartient à une autre table ou appartient déjà à cette table. The row either belongs to another table or already belongs to this table.

L'ajout rend une contrainte non valide. The addition invalidates a constraint.

L'ajout tente d'insérer une valeur null dans un DataColumn dont AllowDBNull a la valeur false. The addition tries to put a null in a DataColumn where AllowDBNull is false.

Examples

L’exemple suivant utilise le Add méthode pour ajouter un nouveau DataRow à un DataRowCollection objet.The following example uses the Add method to add a new DataRow to a DataRowCollection object.

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

Remarks

Pour créer un nouveau DataRow, vous devez utiliser le NewRow méthode de la DataTable classe.To create a new DataRow, you must use the NewRow method of the DataTable class. Lorsque vous utilisez le NewRow (méthode), un nouveau DataRow est retourné en utilisant le schéma du parent DataTable.When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. Après avoir créé le DataRow de l’objet et définissez les valeurs pour chacun de ses colonnes, utilisez le Add pour ajouter l’objet à la collection.After you create the DataRow object and set the values for each of its columns, use the Add method to add the object to the collection.

Génère une exception si l’utilisateur génère une exception dans le RowChanging événement.Generates an exception if the user generates an exception in the RowChanging event. Si une exception se produit, la ligne n’est pas ajoutée à la table.If an exception occurs, the row is not added to the table.

See Also

Add(Object[]) Add(Object[]) Add(Object[]) Add(Object[])

Crée une ligne à l'aide des valeurs spécifiées et l'ajoute à DataRowCollection. Creates a row using specified values and adds it to the DataRowCollection.

public:
 System::Data::DataRow ^ Add(... cli::array <System::Object ^> ^ values);
public System.Data.DataRow Add (params object[] values);
member this.Add : obj[] -> System.Data.DataRow
Public Function Add (ParamArray values As Object()) As DataRow

Paramètres

values
Object[]

Tableau des valeurs utilisées pour créer la nouvelle ligne. The array of values that are used to create the new row.

Returns

Exceptions

Le tableau contient un nombre de colonnes supérieur à celui de la table. The array is larger than the number of columns in the table.

Une valeur ne correspond pas à son type de colonne respectif. A value does not match its respective column type.

L'ajout de la ligne rend une contrainte non valide. Adding the row invalidates a constraint.

Tentative d'insertion d'une valeur null dans une colonne dont AllowDBNull a la valeur false. Trying to put a null in a column where AllowDBNull is false.

Examples

L’exemple suivant utilise le Add méthode pour créer et ajouter un nouveau DataRow de l’objet à un DataRowCollection.The following example uses the Add method to create and add a new DataRow object to a 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

Remarks

Si un DataColumn objet présente ses AutoIncrement définie sur True, null doit être passé pour obtenir la valeur par défaut de cette colonne.If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

Exceptions peuvent également se produire si vous générez une exception pendant un ColumnChanging ou RowChanging événement.Exceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. Si une exception se produit, la ligne n’est pas ajoutée à la table.If an exception occurs, the row is not added to the table.

See Also

Applies to