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

Definition

Fügt der DataRow einen DataRowCollection hinzu.Adds a DataRow to the DataRowCollection.

Überlädt

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

Fügt dem DataRow-Objekt die angegebene DataRowCollection hinzu.Adds the specified DataRow to the DataRowCollection object.

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

Erstellt eine Zeile mit den angegebenen Werten und fügt diese der DataRowCollection hinzu.Creates a row using specified values and adds it to the DataRowCollection.

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

Fügt dem DataRow-Objekt die angegebene DataRowCollection hinzu.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)

Parameter

row
DataRow DataRow DataRow DataRow

Das hinzuzufügende DataRow.The DataRow to add.

Ausnahmen

Die Zeile gehört entweder zu einer anderen Tabelle, oder sie gehört bereits zu dieser Tabelle.The row either belongs to another table or already belongs to this table.

Durch das Hinzufügen wird eine Einschränkung ungültig gemacht.The addition invalidates a constraint.

Beim Hinzufügen wird versucht, eine NULL in einer DataColumn zu platzieren, in der AllowDBNull False ist.The addition tries to put a null in a DataColumn where AllowDBNull is false.

Beispiele

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

Hinweise

Zum Erstellen eines neuen DataRowmüssen Sie die NewRow -Methode der DataTable -Klasse verwenden.To create a new DataRow, you must use the NewRow method of the DataTable class. Wenn Sie die NewRow -Methode verwenden, wird DataRow ein neues-Objekt unter Verwendung des über DataTablegeordneten Schemas zurückgegeben.When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. Nachdem Sie das DataRow -Objekt erstellt und die Werte für jede seiner Spalten festgelegt haben, Add verwenden Sie die-Methode, um das-Objekt der-Auflistung hinzuzufügen.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.

Generiert eine Ausnahme, wenn der Benutzer eine Ausnahme im RowChanging -Ereignis generiert.Generates an exception if the user generates an exception in the RowChanging event. Wenn eine Ausnahme auftritt, wird die Zeile nicht zur Tabelle hinzugefügt.If an exception occurs, the row is not added to the table.

Siehe auch

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

Erstellt eine Zeile mit den angegebenen Werten und fügt diese der DataRowCollection hinzu.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

Parameter

values
Object[]

Das Array von Werten, mit denen die neue Zeile erstellt wird.The array of values that are used to create the new row.

Gibt zurück

Ausnahmen

Das Array ist größer als die Anzahl der Spalten in der Tabelle.The array is larger than the number of columns in the table.

Ein Wert stimmt nicht mit seinem entsprechenden Spaltentyp überein.A value does not match its respective column type.

Durch das Hinzufügen der Zeile wird eine Einschränkung für ungültig erklärt.Adding the row invalidates a constraint.

Es wird versucht, einen NULL-Wert in einer Spalte zu platzieren, in der AllowDBNull False ist.Trying to put a null in a column where AllowDBNull is false.

Beispiele

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

Hinweise

Wenn das DataColumn -Objekt für AutoIncrement ein-Objekt auf true festgelegt ist, sollte NULL zum erhalten des Standardwerts für diese Spalte übermittelt werden.If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

Ausnahmen können auch auftreten, wenn Sie eine Ausnahme während eines- ColumnChanging Ereignisses RowChanging oder eines-Ereignisses generieren.Exceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. Wenn eine Ausnahme auftritt, wird die Zeile nicht zur Tabelle hinzugefügt.If an exception occurs, the row is not added to the table.

Siehe auch

Gilt für: