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

Definizione

Aggiunge un oggetto DataRow a DataRowCollection.Adds a DataRow to the DataRowCollection.

Overload

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

Aggiunge l'oggetto DataRow specificato all'oggetto DataRowCollection.Adds the specified DataRow to the DataRowCollection object.

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

Crea una riga utilizzando i valori specificati e la aggiunge all'insieme DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

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

Aggiunge l'oggetto DataRow specificato all'oggetto 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)

Parametri

row
DataRow DataRow DataRow DataRow

Oggetto DataRow da aggiungere.The DataRow to add.

Eccezioni

La riga appartiene a un'altra tabella o appartiene già a questa tabella.The row either belongs to another table or already belongs to this table.

L'aggiunta invalida un vincolo.The addition invalidates a constraint.

Con l'aggiunta si tenta di immettere un valore null in un oggetto DataColumn in cui AllowDBNull è impostata su false.The addition tries to put a null in a DataColumn where AllowDBNull is false.

Esempi

Nell'esempio seguente viene usato Add il metodo per aggiungere un DataRow nuovo oggetto DataRowCollection a un oggetto.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

Commenti

Per creare un nuovo DataRow, è necessario usare il NewRow metodo della DataTable classe.To create a new DataRow, you must use the NewRow method of the DataTable class. Quando si utilizza il NewRow metodo, viene restituito DataRow un nuovo oggetto utilizzando lo schema dell'elemento DataTablepadre.When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. Dopo aver creato l' DataRow oggetto e impostato i valori per ognuna delle relative colonne, utilizzare il Add metodo per aggiungere l'oggetto alla raccolta.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.

Genera un'eccezione se l'utente genera un'eccezione nell' RowChanging evento.Generates an exception if the user generates an exception in the RowChanging event. Se si verifica un'eccezione, la riga non viene aggiunta alla tabella.If an exception occurs, the row is not added to the table.

Vedi anche

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

Crea una riga utilizzando i valori specificati e la aggiunge all'insieme DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

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

Parametri

values
Object[]

Matrice di valori utilizzati per creare la nuova riga.The array of values that are used to create the new row.

Restituisce

Nessuno.None.

Eccezioni

La matrice è maggiore del numero di colonne nella tabella.The array is larger than the number of columns in the table.

Un valore non corrisponde al rispettivo tipo di colonna.A value does not match its respective column type.

L'aggiunta della riga invalida un vincolo.Adding the row invalidates a constraint.

Tentativo di immissione di un valore null in una colonna in cui la proprietà AllowDBNull è impostata su false.Trying to put a null in a column where AllowDBNull is false.

Esempi

Nell'esempio seguente viene usato Add il metodo per creare e aggiungere un DataRow nuovo oggetto a DataRowCollectionun oggetto.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

Commenti

Se la DataColumn proprietà di un AutoIncrement oggetto è impostata su true, è necessario passare null per ottenere il valore predefinito per la colonna.If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

Le eccezioni possono verificarsi anche se si genera un'eccezione durante un ColumnChanging evento RowChanging o.Exceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. Se si verifica un'eccezione, la riga non viene aggiunta alla tabella.If an exception occurs, the row is not added to the table.

Vedi anche

Si applica a