DataTableCollection.Add 方法

定義

命名空間:

System.Data

組件:

System.Data.Common.dll

將 DataTable 物件加入至集合。

多載

Add()	使用預設名稱建立新的 DataTable 物件，並將它加入至集合。
Add(DataTable)	將指定的 DataTable 加入至集合。
Add(String)	使用指定的名稱建立 DataTable 物件，並將它加入至集合。
Add(String, String)	使用指定的名稱建立 DataTable 物件，並將它加入至集合。

Add()

來源:

DataTableCollection.cs

使用預設名稱建立新的 DataTable 物件，並將它加入至集合。

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

public System.Data.DataTable Add ();

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

Public Function Add () As DataTable

傳回

DataTable

新建立的 DataTable。

範例

下列範例會使用 Add 不含自變數的 方法，將三個新的 DataTable 物件新增至 DataTableCollection 。

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

備註

因為未指定任何名稱， DataTable 所以會使用預設名稱來建立 ，相對於其加法順序。 預設名稱為 「Table1」。

成功 CollectionChanged 將數據表加入至集合時，就會發生此事件。

另請參閱

• DataTable
• Remove(DataTable)
• Clear()

Add(DataTable)

來源:

DataTableCollection.cs

將指定的 DataTable 加入至集合。

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)

參數

table

DataTable

要加入的 DataTable 物件。

例外狀況

ArgumentNullException

資料表的指定值為 null。

ArgumentException

資料表永遠屬於這個集合，或屬於另一個集合。

DuplicateNameException

集合中的資料表具有相同的名稱 (名稱比較不區分大小寫)。

範例

下列範例會建立 ， DataTable 並將其新增至 DataTableCollection 的 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);
}

備註

成功 CollectionChanged 將數據表加入至集合時，就會發生此事件。

另請參閱

• DataTable
• Remove(DataTable)
• Clear()

Add(String)

來源:

DataTableCollection.cs

使用指定的名稱建立 DataTable 物件，並將它加入至集合。

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

參數

name

String

要給建立的 DataTable 的名稱。

傳回

DataTable

新建立的 DataTable。

例外狀況

DuplicateNameException

集合中的資料表具有相同的名稱 (名稱比較不區分大小寫)。

範例

下列範例會將具有指定名稱的 DataTableCollection加入 DataTable 。

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

備註

null如果或空字串 (「) 傳入，則會將預設名稱指定給新建立DataTable的 。 此名稱是以數據表加入 (“Table1”、“Table2” 等) 的順序為基礎。

如果數據表成功加入至集合，就會 CollectionChanged 發生此事件。

另請參閱

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

來源:

DataTableCollection.cs

使用指定的名稱建立 DataTable 物件，並將它加入至集合。

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

參數

name

String

要給建立的 DataTable 的名稱。

tableNamespace

String

要給所建立 DataTable 的命名空間。

傳回

DataTable

新建立的 DataTable。

例外狀況

DuplicateNameException

集合中的資料表具有相同的名稱 (名稱比較不區分大小寫)。

範例

下列範例會將具有指定名稱的 DataTableCollection加入 DataTable 。

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

備註

null如果或空字串 (「) 傳入，則會將預設名稱指定給新建立DataTable的 。 此名稱是以數據表加入 (“Table1”、“Table2” 等) 的順序為基礎。

如果數據表成功加入至集合，就會 CollectionChanged 發生此事件。

另請參閱

• DataTable
• Remove(DataTable)
• Clear()