DataView.ToTable Method (Boolean, String[])

 

Creates and returns a new DataTable based on rows in an existing DataView.

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

member ToTable : 
        distinct:bool *
        [<ParamArrayAttribute>] columnNames:string[] -> DataTable

Parameters

distinct
Type: System.Boolean

If true, the returned DataTable contains rows that have distinct values for all its columns. The default value is false.

columnNames
Type: System.String[]

A string array that contains a list of the column names to be included in the returned DataTable. The DataTable contains the specified columns in the order they appear within this array.

Return Value

Type: System.Data.DataTable

A new DataTable instance that contains the requested rows and columns.

Because this method does not let you specify the name for the output DataTable, its name is the same as the name of the source DataTable.

The following console application example creates a DataTable, fills the DataTablewith data, sorts the DataView, and finally creates a DataTablewith just two columns, limited to rows in which all values are unique.

No code example is currently available or this language may not be supported.

The example displays the following output in the console window:

Original table name: NewTable
Current Values in Table
1, Fruit, Apple, 14
2, Fruit, Orange, 27
3, Bread, Muffin, 23
4, Fish, Salmon, 12
5, Fish, Salmon, 15
6, Bread, Croissant, 23

Current Values in View
3, Bread, Muffin, 23
6, Bread, Croissant, 23
4, Fish, Salmon, 12
5, Fish, Salmon, 15
1, Fruit, Apple, 14
2, Fruit, Orange, 27

Table created from sorted DataView
Bread, 23
Fish, 12
Fish, 15
Fruit, 14
Fruit, 27

New table name: NewTable

.NET Framework
Available since 2.0
Return to top
Show: