DataRowCollection.Add Metoda

Definice

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
Zdroj:
DataRowCollection.cs
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

Řádek má hodnotu null.

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

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

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é

Platí pro

Add(Object[])

Zdroj:
DataRowCollection.cs
Zdroj:
DataRowCollection.cs
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:
 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

Parametry

values
Object[]

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

Návraty

Nový řádek

Výjimky

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

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

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

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é

Platí pro