DataRowCollection.Add Metoda

Definice

Přetížení

Add(DataRow)

Přidá zadaný DataRow DataRowCollection objekt do objektu.Adds the specified DataRow to the DataRowCollection object.

Add(Object[])

Vytvoří řádek s použitím zadaných hodnot a přidá jej do DataRowCollection.Creates a row using specified values and adds it to the DataRowCollection.

Add(DataRow)

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

Parametry

row
DataRow

DataRow Pro přidání.The DataRow to add.

Výjimky

Řádek má hodnotu null.The row is null.

Řádek buď patří do jiné tabulky, nebo již patří do této tabulky.The row either belongs to another table or already belongs to this table.

Přidání neověřuje omezení.The addition invalidates a constraint.

Sčítání se pokusí vložit hodnotu null v DataColumn WHERE, kde AllowDBNull je false.The addition tries to put a null in a DataColumn where AllowDBNull is false.

Příklady

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

Poznámky

Chcete-li vytvořit DataRownový, musíte NewRow použít metodu DataTable třídy.To create a new DataRow, you must use the NewRow method of the DataTable class. Při použití NewRow metody je vrácen nový DataRow objekt pomocí schématu nadřazeného DataTableobjektu.When you use the NewRow method, a new DataRow object is returned using the schema of parent DataTable. Poté, co vytvoříte DataRow objekt a nastavíte hodnoty pro každý z jeho sloupců, Add použijte metodu pro přidání objektu do kolekce.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.

Vygeneruje výjimku, pokud uživatel v RowChanging události vygeneruje výjimku.Generates an exception if the user generates an exception in the RowChanging event. Pokud dojde k výjimce, není řádek přidán do tabulky.If an exception occurs, the row is not added to the table.

Viz také

Add(Object[])

Vytvoří řádek s použitím zadaných hodnot a přidá jej do DataRowCollection.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

Parametry

values
Object[]

Pole hodnot, které se používají k vytvoření nového řádku.The array of values that are used to create the new row.

Návraty

ŽádnéNone.

Výjimky

Pole je větší než počet sloupců v tabulce.The array is larger than the number of columns in the table.

Hodnota neodpovídá příslušnému typu sloupce.A value does not match its respective column type.

Přidáním řádku se zruší platnost omezení.Adding the row invalidates a constraint.

Probíhá pokus o vložení hodnoty null do sloupce, AllowDBNull kde je hodnota false.Trying to put a null in a column where AllowDBNull is false.

Příklady

Následující příklad používá Add metodu k vytvoření a přidání nového DataRow objektu do DataRowCollection.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

Poznámky

DataColumn Pokud máobjektnastavennahodnotutrue,mělabybýtpředánahodnotanull,abysezískalavýchozíhodnotaAutoIncrement pro tento sloupec.If a DataColumn object has its AutoIncrement set to True, null should be passed to get the default value for that column.

Výjimky mohou nastat také v ColumnChanging případě, že vygenerujete výjimku během události nebo. RowChangingExceptions can also occur if you generate an exception during either a ColumnChanging or RowChanging event. Pokud dojde k výjimce, není řádek přidán do tabulky.If an exception occurs, the row is not added to the table.

Viz také

Platí pro