DataRowCollection.Add Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

DataRow Menambahkan ke DataRowCollection.

Overload

Add(DataRow)	Menambahkan yang ditentukan DataRow ke DataRowCollection objek.
Add(Object[])	Membuat baris menggunakan nilai yang ditentukan dan menambahkannya ke DataRowCollection.

Add(DataRow)

Sumber:

DataRowCollection.cs

Menambahkan yang ditentukan DataRow ke DataRowCollection objek.

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)

Parameter

row

DataRow

yang DataRow akan ditambahkan.

Pengecualian

ArgumentNullException

Baris null.

ArgumentException

Baris milik tabel lain atau sudah menjadi milik tabel ini.

ConstraintException

Penambahan membatalkan batasan.

NoNullAllowedException

Penambahan mencoba menempatkan null di DataColumn tempat AllowDBNull yang salah.

Contoh

Contoh berikut menggunakan Add metode untuk menambahkan baru DataRow ke DataRowCollection objek.

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

Keterangan

Untuk membuat baru DataRow, Anda harus menggunakan NewRow metode DataTable kelas . Saat Anda menggunakan metode , NewRow objek baru DataRow dikembalikan menggunakan skema induk DataTable. Setelah Anda membuat DataRow objek dan mengatur nilai untuk setiap kolomnya, gunakan Add metode untuk menambahkan objek ke koleksi.

Menghasilkan pengecualian jika pengguna menghasilkan pengecualian dalam peristiwa tersebut RowChanging . Jika terjadi pengecualian, baris tidak ditambahkan ke tabel.

Lihat juga

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

Add(Object[])

Sumber:

DataRowCollection.cs

Membuat baris menggunakan nilai yang ditentukan dan menambahkannya ke 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

Parameter

values

Object[]

Array nilai yang digunakan untuk membuat baris baru.

Mengembalikan

DataRow

Baris baru.

Pengecualian

ArgumentException

Array lebih besar dari jumlah kolom dalam tabel.

InvalidCastException

Nilai tidak cocok dengan jenis kolom masing-masing.

ConstraintException

Menambahkan baris membatalkan batasan.

NoNullAllowedException

Mencoba untuk menempatkan null dalam kolom di mana AllowDBNull false.

Contoh

Contoh berikut menggunakan Add metode untuk membuat dan menambahkan objek baru DataRow ke 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

Keterangan

DataColumn Jika objek telah AutoIncrement diatur ke True, null harus diteruskan untuk mendapatkan nilai default untuk kolom tersebut.

Pengecualian juga dapat terjadi jika Anda menghasilkan pengecualian selama ColumnChanging peristiwa atau RowChanging . Jika terjadi pengecualian, baris tidak ditambahkan ke tabel.

Lihat juga

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