DataRowCollection.Add Metoda

Definice

Obor názvů:

System.Data

Sestavení:

netstandard.dll, System.Data.Common.dll

Přidá DataRow do DataRowCollection.

Přetížení

Name	Description
Add(DataRow)	Přidá zadaný DataRow objekt DataRowCollection .
Add(Object[])	Vytvoří řádek pomocí zadaných hodnot a přidá ho do objektu DataRowCollection.

Add(DataRow)

Zdroj:

DataRowCollection.cs

Přidá zadaný DataRow objekt 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)

Parametry

row

DataRow

Přidání DataRow

Výjimky

ArgumentNullException

Řádek má hodnotu null.

ArgumentException

Řádek patří do jiné tabulky nebo již patří do této tabulky.

ConstraintException

Přidání zneplatní omezení.

NoNullAllowedException

Přidání se pokusí vložit hodnotu null do místa DataColumn , kde AllowDBNull je false.

Příklady

Následující příklad používá metodu Add k přidání nového DataRow objektu DataRowCollection .

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

Poznámky

Chcete-li vytvořit novou DataRow, musíte použít NewRow metodu DataTable třídy. Při použití NewRow metody se vrátí nový DataRow objekt pomocí schématu nadřazeného DataTableobjektu . Po vytvoření objektu DataRow a nastavení hodnot pro každý z jeho sloupců použijte metodu Add pro přidání objektu do kolekce.

Vygeneruje výjimku, pokud uživatel v události vygeneruje RowChanging výjimku. Pokud dojde k výjimce, řádek se do tabulky nepřidá.

Viz také

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

Add(Object[])

Zdroj:

DataRowCollection.cs

Vytvoří řádek pomocí zadaných hodnot a přidá ho do objektu 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

Parametry

values

Object[]

Pole hodnot, které se používají k vytvoření nového řádku.

Návraty

DataRow

Nový řádek.

Výjimky

ArgumentException

Matice je větší než počet sloupců v tabulce.

InvalidCastException

Hodnota neodpovídá příslušnému typu sloupce.

ConstraintException

Přidání řádku zneplatní omezení.

NoNullAllowedException

Pokoušíte se vložit hodnotu null do sloupce, kde AllowDBNull je false.

Příklady

Následující příklad používá metodu Add k vytvoření a přidání nového DataRow objektu DataRowCollectiondo .

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

Poznámky

DataColumn Pokud má objekt nastavenou AutoIncrement hodnotu True, měla by být předána hodnota null, aby se získala výchozí hodnota pro daný sloupec.

K výjimkám může dojít také v případě, že během ColumnChanging události nebo události RowChanging vygenerujete výjimku. Pokud dojde k výjimce, řádek se do tabulky nepřidá.

Viz také

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