共用方式為


DataTableCollection.Add 方法

定義

DataTable 物件加入至集合。

多載

Add()

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

Add(DataTable)

將指定的 DataTable 加入至集合。

Add(String)

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

Add(String, String)

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

Add()

來源:
DataTableCollection.cs
來源:
DataTableCollection.cs
來源:
DataTableCollection.cs

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

public:
 System::Data::DataTable ^ Add();
public:
 virtual System::Data::DataTable ^ Add();
public System.Data.DataTable Add ();
public virtual System.Data.DataTable Add ();
member this.Add : unit -> System.Data.DataTable
abstract member Add : unit -> System.Data.DataTable
override this.Add : unit -> System.Data.DataTable
Public Function Add () As DataTable
Public Overridable Function Add () As 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 將數據表加入至集合時,就會發生此事件。

另請參閱

適用於

Add(DataTable)

來源:
DataTableCollection.cs
來源:
DataTableCollection.cs
來源:
DataTableCollection.cs

將指定的 DataTable 加入至集合。

public:
 void Add(System::Data::DataTable ^ table);
public:
 virtual void Add(System::Data::DataTable ^ table);
public void Add (System.Data.DataTable table);
public virtual void Add (System.Data.DataTable table);
member this.Add : System.Data.DataTable -> unit
abstract member Add : System.Data.DataTable -> unit
override this.Add : System.Data.DataTable -> unit
Public Sub Add (table As DataTable)
Public Overridable Sub Add (table As DataTable)

參數

table
DataTable

要加入的 DataTable 物件。

例外狀況

資料表的指定值為 null

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

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

範例

下列範例會建立 , DataTable 並將其新增至 DataTableCollectionDataSet

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 將數據表加入至集合時,就會發生此事件。

另請參閱

適用於

Add(String)

來源:
DataTableCollection.cs
來源:
DataTableCollection.cs
來源:
DataTableCollection.cs

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

public:
 System::Data::DataTable ^ Add(System::String ^ name);
public:
 virtual System::Data::DataTable ^ Add(System::String ^ name);
public System.Data.DataTable Add (string? name);
public System.Data.DataTable Add (string name);
public virtual System.Data.DataTable Add (string name);
member this.Add : string -> System.Data.DataTable
abstract member Add : string -> System.Data.DataTable
override this.Add : string -> System.Data.DataTable
Public Function Add (name As String) As DataTable
Public Overridable Function Add (name As String) As DataTable

參數

name
String

要給建立的 DataTable 的名稱。

傳回

新建立的 DataTable

例外狀況

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

範例

下列範例會將具有指定名稱的 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 發生此事件。

另請參閱

適用於

Add(String, String)

來源:
DataTableCollection.cs
來源:
DataTableCollection.cs
來源:
DataTableCollection.cs

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

public:
 System::Data::DataTable ^ Add(System::String ^ name, System::String ^ tableNamespace);
public System.Data.DataTable Add (string? name, 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

例外狀況

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

範例

下列範例會將具有指定名稱的 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 發生此事件。

另請參閱

適用於