DataRowCollection.Add Método

Definición

Espacio de nombres:

System.Data

Ensamblado:

System.Data.Common.dll

Agrega un objeto DataRow a DataRowCollection.

Sobrecargas

Add(DataRow)	Agrega el DataRow especificado al objeto DataRowCollection.
Add(Object[])	Crea una fila mediante los valores especificados y la agrega a DataRowCollection.

Add(DataRow)

Source:

DataRowCollection.cs

Agrega el DataRow especificado al objeto DataRowCollection.

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)

Parámetros

row

DataRow

DataRow que se va a agregar.

Excepciones

ArgumentNullException

La fila es nula.

ArgumentException

La fila pertenece a otra tabla o ya pertenece a ésta.

ConstraintException

La adición invalida una restricción.

NoNullAllowedException

La adición intenta colocar un valor nulo en DataColumn donde AllowDBNull sea falso.

Ejemplos

En el ejemplo siguiente se usa el Add método para agregar un nuevo DataRow objeto a un DataRowCollection objeto .

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

Comentarios

Para crear un objeto , DataRowdebe usar el NewRow método de la DataTable clase . Cuando se usa el NewRow método , se devuelve un nuevo DataRow objeto mediante el esquema del elemento primario DataTable. Después de crear el DataRow objeto y establecer los valores de cada una de sus columnas, use el Add método para agregar el objeto a la colección.

Genera una excepción si el usuario genera una excepción en el RowChanging evento . Si se produce una excepción, la fila no se agrega a la tabla.

Consulte también

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

Add(Object[])

Source:

DataRowCollection.cs

Crea una fila mediante los valores especificados y la agrega a 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

Parámetros

values

Object[]

Matriz de valores que se utiliza para crear la nueva fila.

Devoluciones

DataRow

Nueva fila.

Excepciones

ArgumentException

La matriz es mayor que el número de columnas de la tabla.

InvalidCastException

Un valor no coincide con su tipo de columna respectivo.

ConstraintException

La adición de la fila invalida una restricción.

NoNullAllowedException

Se ha intentado colocar un valor null en una columna en la que AllowDBNull es false.

Ejemplos

En el ejemplo siguiente se usa el Add método para crear y agregar un nuevo DataRow objeto 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

Comentarios

Si un DataColumn objeto tiene establecido AutoIncrement en True, se debe pasar null para obtener el valor predeterminado de esa columna.

También se pueden producir excepciones si se genera una excepción durante un ColumnChanging evento o RowChanging . Si se produce una excepción, la fila no se agrega a la tabla.

Consulte también

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