DataRowCollection.Add Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Aggiunge un oggetto DataRow a DataRowCollection.

Overload

Add(DataRow)	Aggiunge l'oggetto DataRow specificato all'oggetto DataRowCollection.
Add(Object[])	Crea una riga utilizzando i valori specificati e la aggiunge all'insieme DataRowCollection.

Add(DataRow)

Origine:

DataRowCollection.cs

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

Parametri

row

DataRow

Oggetto DataRow da aggiungere.

Eccezioni

ArgumentNullException

La riga è null.

ArgumentException

La riga appartiene a un'altra tabella o appartiene già a questa tabella.

ConstraintException

L'aggiunta invalida un vincolo.

NoNullAllowedException

Con l'aggiunta si tenta di immettere un valore null in un oggetto DataColumn in cui AllowDBNull è impostata su false.

Esempio

Nell'esempio seguente viene usato il Add metodo per aggiungere un nuovo DataRow a un DataRowCollection oggetto.

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 DataRowoggetto , è necessario usare il NewRow metodo della DataTable classe . Quando si usa il NewRow metodo, viene restituito un nuovo DataRow oggetto usando lo schema di padre DataTable. Dopo aver creato l'oggetto DataRow e impostato i valori per ognuna delle relative colonne, usare il Add metodo per aggiungere l'oggetto all'insieme.

Genera un'eccezione se l'utente genera un'eccezione nell'evento RowChanging . Se si verifica un'eccezione, la riga non viene aggiunta alla tabella.

Vedi anche

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

Add(Object[])

Origine:

DataRowCollection.cs

Crea una riga utilizzando i valori specificati e la aggiunge all'insieme 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

Parametri

values

Object[]

Matrice di valori utilizzati per creare la nuova riga.

Restituisce

DataRow

Nuova riga.

Eccezioni

ArgumentException

La matrice è maggiore del numero di colonne nella tabella.

InvalidCastException

Un valore non corrisponde al rispettivo tipo di colonna.

ConstraintException

L'aggiunta della riga invalida un vincolo.

NoNullAllowedException

Tentativo di immissione di un valore null in una colonna in cui la proprietà AllowDBNull è impostata su false.

Esempio

Nell'esempio seguente viene usato il Add metodo per creare e aggiungere un nuovo DataRow oggetto a un DataRowCollectionoggetto .

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 un DataColumn oggetto ha AutoIncrement il relativo set su True, null deve essere passato per ottenere il valore predefinito per tale colonna.

Le eccezioni possono verificarsi anche se si genera un'eccezione durante un ColumnChanging evento o RowChanging . Se si verifica un'eccezione, la riga non viene aggiunta alla tabella.

Vedi anche

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