DataTableCollection.Add 方法

定義

命名空間:: System.Data

組件:: netstandard.dll, System.Data.Common.dll

組件:: System.Data.Common.dll

組件:: System.Data.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

新增一個 DataTable 物件到集合中。

多載

名稱	Description
Add()	使用預設名稱建立一個新 DataTable 物件，並將其加入集合。
Add(DataTable)	將指定的 `DataTable` 資料加入集合。
Add(String)	使用指定的名稱建立 DataTable 物件，並將其加入集合。
Add(String, String)	使用指定的名稱建立 DataTable 物件，並將其加入集合。

Add()

來源:: DataTableCollection.cs

來源:: DataTableCollection.cs

來源:: 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

新創造 DataTable的。

範例

以下範例在使用DataTable無參數的方法時新增三個DataTableCollection物件Add。

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

來源:: 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要補充的目標。

例外狀況

ArgumentNullException

表格指定的值為 null。

ArgumentException

該表格已屬於此集合，或屬於另一個集合。

DuplicateNameException

集合中的一個表格名稱相同。這個比較並不區分大小寫。

範例

以下範例建立 a 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 事件就會發生。

另請參閱

適用於

Add(String)

來源:: DataTableCollection.cs

來源:: DataTableCollection.cs

來源:: 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

新創造 DataTable的。

例外狀況

DuplicateNameException

集合中的一個表格名稱相同。（此比較不區分大小寫。）

範例

以下範例將帶有名稱的 a DataTable 加入 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

備註

若傳入空 null 字串（“”），則新建立 DataTable的會被賦予預設名稱。此名稱依據資料表加入的順序（「Table1」、「Table2」等）。

當該資料表成功加入集合時，該 CollectionChanged 事件就會發生。

另請參閱

適用於

Add(String, String)

來源:: DataTableCollection.cs

來源:: DataTableCollection.cs

來源:: 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

新創造 DataTable的。

例外狀況

DuplicateNameException

集合中的一個表格名稱相同。（此比較不區分大小寫。）

範例

以下範例將帶有名稱的 a DataTable 加入 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

備註

若傳入空 null 字串（“”），則新建立 DataTable的會被賦予預設名稱。此名稱依據資料表加入的順序（「Table1」、「Table2」等）。

當該資料表成功加入集合時，該 CollectionChanged 事件就會發生。

另請參閱

適用於

意見反應

此頁面對您有幫助嗎？