DataTableCollection.Add Metode

Definisi

Ruang nama:

System.Data

Rakitan:

System.Data.Common.dll

DataTable Menambahkan objek ke koleksi.

Overload

Add()	Membuat objek baru DataTable dengan menggunakan nama default dan menambahkannya ke koleksi.
Add(DataTable)	Menambahkan yang ditentukan DataTable ke koleksi.
Add(String)	DataTable Membuat objek dengan menggunakan nama yang ditentukan dan menambahkannya ke koleksi.
Add(String, String)	DataTable Membuat objek dengan menggunakan nama yang ditentukan dan menambahkannya ke koleksi.

Add()

Sumber:

DataTableCollection.cs

Membuat objek baru DataTable dengan menggunakan nama default dan menambahkannya ke koleksi.

public:
 System::Data::DataTable ^ Add();

public System.Data.DataTable Add ();

member this.Add : unit -> System.Data.DataTable

Public Function Add () As DataTable

Mengembalikan

DataTable

Yang baru dibuat DataTable.

Contoh

Contoh berikut menambahkan tiga objek baru DataTable ke DataTableCollection menggunakan Add metode tanpa argumen.

private void AddTables()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    for (int i = 0; i < 3; i++)
        thisDataSet.Tables.Add();
    Console.WriteLine(thisDataSet.Tables.Count.ToString()
        + " tables");
    foreach (DataTable table in thisDataSet.Tables)
        Console.WriteLine(table.TableName);
}

Private Sub AddTables()
   Dim table As DataTable
   
   ' Presuming a DataGrid is displaying more than one table, get its DataSet.
   Dim thisDataSet As DataSet = CType(DataGrid1.DataSource, DataSet)
   Dim i As Integer
   For i = 0 to 2
      thisDataSet.Tables.Add()
   Next i

   Console.WriteLine(thisDataSet.Tables.Count.ToString() & " tables")
   For Each table In thisDataSet.Tables
      Console.WriteLine(table.TableName)
   Next
End Sub

Keterangan

Karena tidak ada nama yang ditentukan, DataTable dibuat dengan menggunakan nama default, relatif terhadap urutan penambahannya. Nama defaultnya adalah "Table1."

Peristiwa CollectionChanged terjadi ketika tabel berhasil ditambahkan ke koleksi.

Lihat juga

• DataTable
• Remove(DataTable)
• Clear()

Add(DataTable)

Sumber:

DataTableCollection.cs

Menambahkan yang ditentukan DataTable ke koleksi.

public:
 void Add(System::Data::DataTable ^ table);

public void Add (System.Data.DataTable table);

member this.Add : System.Data.DataTable -> unit

Public Sub Add (table As DataTable)

Parameter

table

DataTable

Objek DataTable yang akan ditambahkan.

Pengecualian

ArgumentNullException

Nilai yang ditentukan untuk tabel adalah null.

ArgumentException

Tabel sudah menjadi milik koleksi ini, atau milik koleksi lain.

DuplicateNameException

Tabel dalam koleksi memiliki nama yang sama. Perbandingannya tidak peka huruf besar/kecil.

Contoh

Contoh berikut membuat DataTable dan menambahkannya ke DataTableCollection dari DataSet.

private void AddDataTable()
{
    // Get the DataTableCollection of a DataGrid
    // control's DataSet.
    DataTableCollection tables =
        ((DataSet)DataGrid1.DataSource).Tables;

    // Create a new DataTable.
    DataTable table = new DataTable();

    // Code to add columns and rows not shown here.

    // Add the table to the DataTableCollection.
    tables.Add(table);
}

Keterangan

Peristiwa CollectionChanged terjadi ketika tabel berhasil ditambahkan ke koleksi.

Lihat juga

• DataTable
• Remove(DataTable)
• Clear()

Add(String)

Sumber:

DataTableCollection.cs

DataTable Membuat objek dengan menggunakan nama yang ditentukan dan menambahkannya ke koleksi.

public:
 System::Data::DataTable ^ Add(System::String ^ name);

public System.Data.DataTable Add (string? name);

member this.Add : string -> System.Data.DataTable

Public Function Add (name As String) As DataTable

Parameter

name

String

Nama untuk memberikan yang dibuat DataTable.

Mengembalikan

DataTable

Yang baru dibuat DataTable.

Pengecualian

DuplicateNameException

Tabel dalam koleksi memiliki nama yang sama. (Perbandingan tidak peka huruf besar/kecil.)

Contoh

Contoh berikut menambahkan DataTable dengan nama yang diberikan ke DataTableCollection.

private void AddTable()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Use the Add method to add a new table with a given name.
    DataTable table = thisDataSet.Tables.Add("NewTable");

    // Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName);
    Console.WriteLine(thisDataSet.Tables.Count.ToString());
}

Private Sub AddTable()
    ' Presuming a DataGrid is displaying more than one table, 
    ' get its DataSet.
    Dim thisDataSet As DataSet = _
        CType(DataGrid1.DataSource, DataSet)

    ' Use the Add method to add a new table with a given name.
    Dim table As DataTable = thisDataSet.Tables.Add("NewTable")

    ' Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName)
    Console.WriteLine(thisDataSet.Tables.Count.ToString())
End Sub

Keterangan

Jika string null kosong ("") diteruskan, nama default diberikan ke yang baru dibuat DataTable. Nama ini didasarkan pada urutan penambahan tabel ("Table1", "Table2", dan sebagainya).

Peristiwa CollectionChanged terjadi jika tabel berhasil ditambahkan ke koleksi.

Lihat juga

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

Sumber:

DataTableCollection.cs

DataTable Membuat objek dengan menggunakan nama yang ditentukan dan menambahkannya ke koleksi.

public:
 System::Data::DataTable ^ Add(System::String ^ name, System::String ^ tableNamespace);

public System.Data.DataTable Add (string? name, string? tableNamespace);

member this.Add : string * string -> System.Data.DataTable

Public Function Add (name As String, tableNamespace As String) As DataTable

Parameter

name

String

Nama untuk memberikan yang dibuat DataTable.

tableNamespace

String

Namespace layanan untuk memberikan yang dibuat DataTable.

Mengembalikan

DataTable

Yang baru dibuat DataTable.

Pengecualian

DuplicateNameException

Tabel dalam koleksi memiliki nama yang sama. (Perbandingan tidak peka huruf besar/kecil.)

Contoh

Contoh berikut menambahkan DataTable dengan nama yang diberikan ke DataTableCollection.

private void AddTable()
{
    // Presuming a DataGrid is displaying more than one table,
    // get its DataSet.
    DataSet thisDataSet = (DataSet)DataGrid1.DataSource;

    // Use the Add method to add a new table with a given name.
    DataTable table = thisDataSet.Tables.Add("NewTable");

    // Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName);
    Console.WriteLine(thisDataSet.Tables.Count.ToString());
}

Private Sub AddTable()
    ' Presuming a DataGrid is displaying more than one table, 
    ' get its DataSet.
    Dim thisDataSet As DataSet = _
        CType(DataGrid1.DataSource, DataSet)

    ' Use the Add method to add a new table with a given name.
    Dim table As DataTable = thisDataSet.Tables.Add("NewTable")

    ' Code to add columns and rows not shown here.

    Console.WriteLine(table.TableName)
    Console.WriteLine(thisDataSet.Tables.Count.ToString())
End Sub

Keterangan

Jika string null kosong ("") diteruskan, nama default diberikan ke yang baru dibuat DataTable. Nama ini didasarkan pada urutan penambahan tabel ("Table1", "Table2", dan sebagainya).

Peristiwa CollectionChanged terjadi jika tabel berhasil ditambahkan ke koleksi.

Lihat juga

• DataTable
• Remove(DataTable)
• Clear()