DataRowCollection.Add Metoda

Definice

Obor názvů:

System.Data

Sestavení:

System.Data.Common.dll

Přidá do DataRow .DataRowCollection

Přetížení

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

Add(DataRow)

Zdroj:

DataRowCollection.cs

Přidá zadaný DataRow objekt do objektu 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á DataRow se.

Výjimky

ArgumentNullException

Řádek má hodnotu null.

ArgumentException

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

ConstraintException

Přidání zruší platnost omezení.

NoNullAllowedException

Sčítání se pokusí vložit hodnotu null do parametru DataColumn where AllowDBNull is false.

Příklady

Následující příklad používá metodu Add k přidání nového DataRow do 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 je vrácen 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 k přidání objektu do kolekce.

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

Viz také

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

Add(Object[])

Zdroj:

DataRowCollection.cs

Vytvoří řádek pomocí zadaných hodnot a přidá ho DataRowCollectiondo .

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žijí k vytvoření nového řádku.

Návraty

DataRow

Nový řádek

Výjimky

ArgumentException

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

InvalidCastException

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

ConstraintException

Přidáním řádku zrušíte platnost omezení.

NoNullAllowedException

Pokus o vložení hodnoty 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 do objektu 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

Poznámky

Pokud má objekt nastavenou DataColumnAutoIncrement hodnotu True, měla by se předat hodnota null, aby se získala výchozí hodnota pro tento sloupec.

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

Viz také

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