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

Definição

Adiciona um DataRow ao DataRowCollection.Adds a DataRow to the DataRowCollection.

Sobrecargas

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

Adiciona o DataRow especificado ao objeto DataRowCollection.Adds the specified DataRow to the DataRowCollection object.

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

Cria uma linha usando os valores especificados e a adiciona ao DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

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

Adiciona o DataRow especificado ao objeto 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)

Parâmetros

row
DataRow DataRow DataRow DataRow

O DataRow a ser adicionado.The DataRow to add.

Exceções

A linha pertence a outra tabela ou já pertence a esta tabela.The row either belongs to another table or already belongs to this table.

A adição invalida uma restrição.The addition invalidates a constraint.

A adição tenta colocar um valor nulo em um DataColumn em que AllowDBNull é falso.The addition tries to put a null in a DataColumn where AllowDBNull is false.

Exemplos

O exemplo a seguir usa o Add método para adicionar uma nova DataRow para um DataRowCollection objeto.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

Comentários

Para criar um novo DataRow, você deve usar o NewRow método o DataTable classe.To create a new DataRow, you must use the NewRow method of the DataTable class. Quando você usa o NewRow método, um novo DataRow objeto é retornado usando o esquema do pai DataTable.When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. Depois de criar o DataRow do objeto e defina os valores para cada uma de suas colunas, use o Add método para adicionar o objeto à coleção.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.

Gera uma exceção se o usuário gera uma exceção no RowChanging eventos.Generates an exception if the user generates an exception in the RowChanging event. Se ocorrer uma exceção, a linha não será adicionada à tabela.If an exception occurs, the row is not added to the table.

Veja também

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

Cria uma linha usando os valores especificados e a adiciona ao 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

Parâmetros

values
Object[]

Uma matriz de valores usados para criar a nova linha.The array of values that are used to create the new row.

Retornos

nenhuma.None.

Exceções

A matriz é maior que o número de colunas na tabela.The array is larger than the number of columns in the table.

Um valor não corresponde a seu respectivo tipo de coluna.A value does not match its respective column type.

Adicionar a linha invalida uma restrição.Adding the row invalidates a constraint.

Tentativa de colocar um valor nulo em uma coluna em que AllowDBNull é falso.Trying to put a null in a column where AllowDBNull is false.

Exemplos

O exemplo a seguir usa o Add método para criar e adicionar um novo DataRow do objeto para um 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

Comentários

Se um DataColumn objeto tem seu AutoIncrement definido como True, null deve ser passado para obter o valor padrão para essa coluna.If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

Exceções também podem ocorrer se você gerar uma exceção durante a um ColumnChanging ou RowChanging eventos.Exceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. Se ocorrer uma exceção, a linha não será adicionada à tabela.If an exception occurs, the row is not added to the table.

Veja também

Aplica-se a