DataTable.DefaultView Property

.NET Framework (current version)
 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a customized view of the table that may include a filtered view, or a cursor position.

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

C#
C++
F#
VB
Copy 
[BrowsableAttribute(false)]
public DataView DefaultView { get; }

Property Value

Type: System.Data.DataView

The DataView associated with the DataTable.

The DefaultView property returns a DataView you can use to sort, filter, and search a DataTable.

The following example sets a property of the DataTable object's DataView through the DefaultView property. The example also shows the binding of a DataGridView control to a DataTable named "Suppliers" that includes a column named "CompanyName."

C#
VB
Copy 
private void BindDataGrid()
{
    DataTable table = new DataTable();

    // Insert code to populate a DataTable with data.

    // Bind grid to DataTable.
    dataGrid1.DataSource = table;
}

private void ChangeRowFilter()
{
    DataTable gridTable = (DataTable) dataGrid1.DataSource;

    // Set the RowFilter to display a company names that 
    // begin with A through I..
    gridTable.DefaultView.RowFilter = "CompanyName < 'I'";
}

.NET Framework
Available since 1.1
Return to top
Show: