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.

C#

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

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 .

C#

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

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.

C#

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

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

C#

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

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)