DataTableCollection.Add 方法

定义

将对象 DataTable 添加到集合。

重载

名称 说明
Add()

使用默认名称创建新 DataTable 对象,并将其添加到集合中。

Add(DataTable)

将指定的 DataTable 值添加到集合中。

Add(String)

使用指定的名称创建对象 DataTable ,并将其添加到集合中。

Add(String, String)

使用指定的名称创建对象 DataTable ,并将其添加到集合中。

Add()

Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
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三个新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)

Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
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 并将其添加到 DataTableCollection a 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)

Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
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的 。

例外

集合中的表具有相同的名称。 (比较不区分大小写。

示例

以下示例向 添加具有给定名称的 DataTableaDataTableCollection

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)

Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
DataTableCollection.cs
Source:
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的 。

例外

集合中的表具有相同的名称。 (比较不区分大小写。

示例

以下示例向 添加具有给定名称的 DataTableaDataTableCollection

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如果表已成功添加到集合,则会发生该事件。

另请参阅

适用于