Język

DataRowCollection.Add Metoda

Definicja

Przestrzeń nazw:
System.Data
Zestawy:
netstandard.dll, System.Data.Common.dll
Zestaw:
System.Data.Common.dll
Zestaw:
System.Data.dll
Zestaw:
netstandard.dll

Dodaje DataRow do DataRowCollection.

Przeciążenia

Nazwa Opis
Add(DataRow)

Dodaje określony DataRow obiekt DataRowCollection .
Add(Object[])

Tworzy wiersz przy użyciu określonych wartości i dodaje go do elementu DataRowCollection.

Add(DataRow)

Źródło:
DataRowCollection.cs
Źródło:
DataRowCollection.cs
Źródło:
DataRowCollection.cs
Źródło:
DataRowCollection.cs
Źródło:
DataRowCollection.cs

Dodaje określony DataRow obiekt 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

Element do dodania DataRow .

Wyjątki

ArgumentNullException

Wiersz ma wartość null.

ArgumentException

Wiersz należy do innej tabeli lub już należy do tej tabeli.

ConstraintException

Dodanie unieważnia ograniczenie.

NoNullAllowedException

Dodanie próbuje umieścić wartość null w miejscu, w którym DataColumnAllowDBNull ma wartość false.

Przykłady

W poniższym przykładzie użyto Add metody , aby dodać nowy DataRow obiekt 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

Uwagi

Aby utworzyć nowy DataRowelement , należy użyć NewRow metody DataTable klasy . W przypadku użycia NewRow metody zwracany jest nowy DataRow obiekt przy użyciu schematu elementu nadrzędnego DataTable. Po utworzeniu DataRow obiektu i ustawieniu wartości dla każdej z jego kolumn użyj Add metody , aby dodać obiekt do kolekcji.

Generuje wyjątek, jeśli użytkownik wygeneruje RowChanging wyjątek w zdarzeniu. Jeśli wystąpi wyjątek, wiersz nie zostanie dodany do tabeli.

Zobacz też

Dotyczy

Add(Object[])

Źródło:
DataRowCollection.cs
Źródło:
DataRowCollection.cs
Źródło:
DataRowCollection.cs
Źródło:
DataRowCollection.cs
Źródło:
DataRowCollection.cs

Tworzy wiersz przy użyciu określonych wartości i dodaje go do elementu DataRowCollection.

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[]

Tablica wartości używanych do utworzenia nowego wiersza.

Zwraca

DataRow

Nowy wiersz.

Wyjątki

ArgumentException

Tablica jest większa niż liczba kolumn w tabeli.

InvalidCastException

Wartość nie jest zgodna z odpowiednim typem kolumny.

ConstraintException

Dodanie wiersza unieważnia ograniczenie.

NoNullAllowedException

Próba ustawienia wartości null w kolumnie, w której AllowDBNull ma wartość false.

Przykłady

W poniższym przykładzie użyto metody do utworzenia Add i dodania nowego DataRow obiektu do obiektu 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

Uwagi

DataColumn Jeśli obiekt ma ustawioną AutoIncrement wartość True, należy przekazać wartość null, aby uzyskać wartość domyślną dla tej kolumny.

Wyjątki mogą również wystąpić w przypadku wygenerowania wyjątku podczas zdarzenia ColumnChanging lub RowChanging . Jeśli wystąpi wyjątek, wiersz nie zostanie dodany do tabeli.

Zobacz też

Dotyczy