DataRowCollection.Add Metod

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)

Parametrar

Undantag

Exempel

I följande exempel används Add metoden för att lägga till en ny DataRow i ett DataRowCollection objekt.

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

Kommentarer

Om du vill skapa en ny DataRowmåste du använda NewRow -metoden för DataTable klassen. När du använder NewRow metoden returneras ett nytt DataRow objekt med hjälp av schemat för överordnat DataTable. När du har skapat DataRow objektet och angett värdena för var och en av dess kolumner använder du Add metoden för att lägga till objektet i samlingen.

Genererar ett undantag om användaren genererar ett undantag i händelsen RowChanging . Om ett undantag inträffar läggs inte raden till i tabellen.

Se även

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

public:
 virtual System::Data::DataRow ^ Add(cli::array <System::Object ^> ^ values);

public:
 System::Data::DataRow ^ Add(... cli::array <System::Object ^> ^ values);

public virtual System.Data.DataRow Add(object[] values);

public System.Data.DataRow Add(params object[] values);

abstract member Add : obj[] -> System.Data.DataRow
override this.Add : obj[] -> System.Data.DataRow

member this.Add : obj[] -> System.Data.DataRow

Public Overridable Function Add (values As Object()) As DataRow

Public Function Add (ParamArray values As Object()) As DataRow

Parametrar

Returer

Den nya raden.

Undantag

Exempel

I följande exempel används Add metoden för att skapa och lägga till ett nytt DataRow objekt i en 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

Kommentarer

Om ett DataColumn objekt har värdet AutoIncrement True ska null skickas för att hämta standardvärdet för kolumnen.

Undantag kan också inträffa om du genererar ett undantag under en eller RowChanging en ColumnChanging händelse. Om ett undantag inträffar läggs inte raden till i tabellen.

Se även

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