DataRowCollection.Add Methode

Definition

Namespace:
System.Data
Assemblys:
netstandard.dll, System.Data.Common.dll
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

Fügt ein DataRow zu dem DataRowCollection hinzu.

Überlädt

Name Beschreibung
Add(DataRow)

Fügt das angegebene DataRow Objekt hinzu DataRowCollection .
Add(Object[])

Erstellt eine Zeile mit angegebenen Werten und fügt sie der DataRowCollection.

Add(DataRow)

Quelle:
DataRowCollection.cs
Quelle:
DataRowCollection.cs
Quelle:
DataRowCollection.cs
Quelle:
DataRowCollection.cs
Quelle:
DataRowCollection.cs

Fügt das angegebene DataRow Objekt hinzu 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)

Parameter

row
DataRow

Der DataRow hinzuzufügende

Ausnahmen

ArgumentNullException

Die Zeile ist NULL.

ArgumentException

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

ConstraintException

Durch die Addition wird eine Einschränkung ungültig.

NoNullAllowedException

Die Ergänzung versucht, einen Nullwert in eine Stelle zu setzen, DataColumn in der AllowDBNull "false" angegeben ist.

Beispiele

Im folgenden Beispiel wird die Add Methode verwendet, um einem Objekt ein DataRow neues DataRowCollection Objekt 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

Zum Erstellen eines neuen DataRowTyps 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 Objekts DataTablezurückgegeben. Nachdem Sie das DataRow Objekt erstellt und die Werte für die einzelnen 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

Gilt für:

Add(Object[])

Quelle:
DataRowCollection.cs
Quelle:
DataRowCollection.cs
Quelle:
DataRowCollection.cs
Quelle:
DataRowCollection.cs
Quelle:
DataRowCollection.cs

Erstellt eine Zeile mit angegebenen Werten und fügt sie der 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

Parameter

values
Object[]

Das Array von Werten, die zum Erstellen der neuen Zeile verwendet werden.

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 dem jeweiligen Spaltentyp überein.

ConstraintException

Durch Das Hinzufügen der Zeile wird eine Einschränkung ungültig.

NoNullAllowedException

Beim Versuch, eine Null in eine Spalte einzufügen, in AllowDBNull der "false" angegeben ist.

Beispiele

Im folgenden Beispiel wird die Add Methode zum Erstellen und Hinzufügen eines neuen DataRow Objekts zu einem 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 ColumnChanging Ereignisses RowChanging eine Ausnahme generieren. Wenn eine Ausnahme auftritt, wird die Zeile nicht zur Tabelle hinzugefügt.

Weitere Informationen

Gilt für: