Export (0) Print
Expand All

DataTableCollection::Add Method (DataTable)

Adds the specified DataTable to the collection.

Namespace:  System.Data
Assembly:  System.Data (in System.Data.dll)

public:
void Add(
	DataTable^ table
)

Parameters

table
Type: System.Data::DataTable

The DataTable object to add.

ExceptionCondition
ArgumentNullException

The value specified for the table is nullptr.

ArgumentException

The table already belongs to this collection, or belongs to another collection.

DuplicateNameException

A table in the collection has the same name. The comparison is not case sensitive.

The CollectionChanged event occurs when a table is successfully added to the collection.

The following example creates a DataTable and adds it to the DataTableCollection of 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);
}

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5, 3.0, 2.0, 1.1

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft