.NET Framework Class Library
DataTable..::.Select Method (String, String)

Gets an array of all DataRow objects that match the filter criteria, in the specified sort order.

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

Visual Basic (Declaration)
Public Function Select ( _
    filterExpression As String, _
    sort As String _
) As DataRow()
Visual Basic (Usage)
Dim instance As DataTable
Dim filterExpression As String
Dim sort As String
Dim returnValue As DataRow()

returnValue = instance.Select(filterExpression, _
    sort)
C#
public DataRow[] Select(
    string filterExpression,
    string sort
)
Visual C++
public:
array<DataRow^>^ Select(
    String^ filterExpression, 
    String^ sort
)
JScript
public function Select(
    filterExpression : String, 
    sort : String
) : DataRow[]

Parameters

filterExpression
Type: System..::.String
The criteria to use to filter the rows.
sort
Type: System..::.String
A string specifying the column and sort direction.

Return Value

Type: array<System.Data..::.DataRow>[]()[]
An array of DataRow objects matching the filter expression.
Remarks

To form the filterExpression argument, use the same rules for creating the DataColumn class's Expression property value. The Sort argument also uses the same rules for creating class's Expression strings.

Examples

The following example uses a filter expression to return an array of DataRow objects.

Visual Basic
Private Sub GetRowsByFilter()
    Dim table As DataTable = DataSet1.Tables(0)

    ' Presuming the DataTable has a column named Date.
    Dim expression As String = "Date > 1/1/00"

    ' Sort descending by column named CompanyName.
    Dim sortOrder As String = "CompanyName DESC" 
    Dim foundRows() As DataRow

    ' Use the Select method to find all rows matching the filter.
    foundRows = table.Select(expression, sortOrder)

    Dim i As Integer
    ' Print column 0 of each returned row.
    For i = 0 to foundRows.GetUpperBound(0)
       Console.WriteLine(foundRows(i)(0))
    Next i
End Sub
C#
private void GetRowsByFilter()
{
    DataTable table = DataSet1.Tables["Orders"];

    // Presuming the DataTable has a column named Date.
    string expression = "Date > '1/1/00'";

    // Sort descending by column named CompanyName.
    string sortOrder = "CompanyName DESC";
    DataRow[] foundRows;

    // Use the Select method to find all rows matching the filter.
    foundRows = table.Select(expression, sortOrder);

    // Print column 0 of each returned row.
    for(int i = 0; i < foundRows.Length; i ++)
    {
        Console.WriteLine(foundRows[i][0]);
    }
}

Platforms

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC, Xbox 360, Zune

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Version Information

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0, 1.0

XNA Framework

Supported in: 3.0, 2.0, 1.0
See Also

Reference

Other Resources

Tags :


Page view tracker