DataRowCollection.Add Método

Definición

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
Source:
DataRowCollection.cs
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

La fila es nula.

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

La adición invalida una restricción.

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

Se aplica a

Add(Object[])

Source:
DataRowCollection.cs
Source:
DataRowCollection.cs
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:
 virtual System::Data::DataRow ^ Add(cli::array <System::Object ^> ^ values);
public System.Data.DataRow Add (params object?[] values);
public System.Data.DataRow Add (params object[] values);
public virtual System.Data.DataRow Add (object[] values);
member this.Add : obj[] -> System.Data.DataRow
abstract member Add : obj[] -> System.Data.DataRow
override this.Add : obj[] -> System.Data.DataRow
Public Function Add (ParamArray values As Object()) As DataRow
Public Overridable Function Add (values As Object()) As DataRow

Parámetros

values
Object[]

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

Devoluciones

Nueva fila.

Excepciones

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

Un valor no coincide con su tipo de columna respectivo.

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

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

Se aplica a