DataRowCollection.Add Methode

Definition

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Fügt der DataRow einen DataRowCollection hinzu.

Überlädt

Add(DataRow)	Fügt dem DataRow-Objekt die angegebene DataRowCollection hinzu.
Add(Object[])	Erstellt eine Zeile mit den angegebenen Werten und fügt diese der DataRowCollection hinzu.

Add(DataRow)

Quelle:

DataRowCollection.cs

Fügt dem DataRow-Objekt die angegebene DataRowCollection hinzu.

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)

Parameter

row

DataRow

Das hinzuzufügende DataRow.

Ausnahmen

ArgumentNullException

Die Zeile ist NULL.

ArgumentException

Die Zeile gehört entweder zu einer anderen Tabelle, oder sie gehört bereits zu dieser Tabelle.

ConstraintException

Durch das Hinzufügen wird eine Einschränkung ungültig gemacht.

NoNullAllowedException

Beim Hinzufügen wird versucht, eine NULL in einer DataColumn zu platzieren, in der AllowDBNull False ist.

Beispiele

Im folgenden Beispiel wird die Add -Methode verwendet, um einem -Objekt ein DataRowCollection neues DataRow hinzuzufügen.

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

Hinweise

Um eine neue DataRowzu erstellen, müssen Sie die NewRow -Methode der DataTable -Klasse verwenden. Wenn Sie die NewRow -Methode verwenden, wird ein neues DataRow -Objekt mithilfe des Schemas des übergeordneten DataTablezurückgegeben. Nachdem Sie das DataRow Objekt erstellt und die Werte für jede seiner Spalten festgelegt haben, verwenden Sie die Add -Methode, um das -Objekt der Auflistung hinzuzufügen.

Generiert eine Ausnahme, wenn der Benutzer eine Ausnahme im RowChanging -Ereignis generiert. Wenn eine Ausnahme auftritt, wird die Zeile nicht zur Tabelle hinzugefügt.

Weitere Informationen

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

Add(Object[])

Quelle:

DataRowCollection.cs

Erstellt eine Zeile mit den angegebenen Werten und fügt diese der DataRowCollection hinzu.

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

Parameter

values

Object[]

Das Array von Werten, mit denen die neue Zeile erstellt wird.

Gibt zurück

DataRow

Die neue Zeile.

Ausnahmen

ArgumentException

Das Array ist größer als die Anzahl der Spalten in der Tabelle.

InvalidCastException

Ein Wert stimmt nicht mit seinem entsprechenden Spaltentyp überein.

ConstraintException

Durch das Hinzufügen der Zeile wird eine Einschränkung für ungültig erklärt.

NoNullAllowedException

Es wird versucht, einen NULL-Wert in einer Spalte zu platzieren, in der AllowDBNull False ist.

Beispiele

Im folgenden Beispiel wird die Add -Methode verwendet, um ein neues DataRow -Objekt zu erstellen und hinzuzufügen 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

Hinweise

Wenn ein DataColumn Objekt auf True festgelegt ist AutoIncrement , sollte NULL übergeben werden, um den Standardwert für diese Spalte abzurufen.

Ausnahmen können auch auftreten, wenn Sie während eines - oder RowChanging -Ereignisses eine ColumnChanging Ausnahme generieren. Wenn eine Ausnahme auftritt, wird die Zeile nicht zur Tabelle hinzugefügt.

Weitere Informationen

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