DataTableCollection.Add 方法

定义

命名空间:

System.Data

程序集:

System.Data.Common.dll

将 DataTable 对象添加到集合中。

重载

Add()	使用默认名称创建一个新的 DataTable 对象，并将其添加到集合中。
Add(DataTable)	将指定的 DataTable 添加到集合。
Add(String)	使用指定名称创建一个 DataTable 对象，并将其添加到集合中。
Add(String, String)	使用指定名称创建一个 DataTable 对象，并将其添加到集合中。

Add()

Source:

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)

Source:

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)

Source:

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

集合中的某个表具有相同的名称。 （该比较不区分大小写。）

示例

以下示例将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如果成功将表添加到集合中，则会发生该事件。

另请参阅

• DataTable
• Remove(DataTable)
• Clear()

Add(String, String)

Source:

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

集合中的某个表具有相同的名称。 （该比较不区分大小写。）

示例

以下示例将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如果成功将表添加到集合中，则会发生该事件。

另请参阅

• DataTable
• Remove(DataTable)
• Clear()