DataTable.Select メソッド

.NET Framework クラス ライブラリ リファレンス

DataTable.Select メソッド (String, String, DataViewRowState)

フィルタ基準と一致するすべての DataRow オブジェクトの配列を、指定した状態と一致する並べ替え順に取得します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Function Select (
 _
    filterExpression As String, _
    sort As String, _
    recordStates As DataViewRowState _
) As DataRow()

Visual Basic (使用法)

Dim instance As DataTable
Dim filterExpression As String
Dim sort As String
Dim recordStates As DataViewRowState
Dim returnValue As DataRow()

returnValue = instance.Select(filterExpression, sort, recordStates)

C#

public DataRow[] Select (
    string filterExpression,
    string sort,
    DataViewRowState recordStates
)

C++

public:
array<DataRow^>^ Select (
    String^ filterExpression, 
    String^ sort, 
    DataViewRowState recordStates
)

J#

public DataRow[] Select (
    String filterExpression, 
    String sort, 
    DataViewRowState recordStates
)

JScript

public function Select (
    filterExpression : String, 
    sort : String, 
    recordStates : DataViewRowState
) : DataRow[]

パラメータ

filterExpression

行にフィルタをかけるために使用する基準。

sort

列と並べ替え方向を指定する文字列。

recordStates

DataViewRowState 値の 1 つ。

戻り値
DataRow オブジェクトの配列。

解説

引数 filterExpression を作成するには、DataColumn クラスの Expression プロパティの値を作成するときと同じ規則を使用します。引数 Sort は、クラスの Expression 文字列を作成するときと同じ規則も使用します。

使用例

フィルタ式とレコードの状態を使用して、DataRow オブジェクトの配列を返す例を次に示します。

Visual Basic

Private Sub GetRowsByFilter()

    Dim customerTable As DataTable = New
 DataTable("Customers")

    ' Add columns
    customerTable.Columns.Add("id", GetType(Integer))
    customerTable.Columns.Add("name", GetType(String))

    ' Set PrimaryKey
    customerTable.Columns("id").Unique = True
    customerTable.PrimaryKey = New DataColumn() _
        {customerTable.Columns("id")}

    ' add ten rows
    Dim id As Integer
    For id = 1 To 10
        customerTable.Rows.Add( _
        New Object() {id, String.Format("customer{0}",
 id)})
    Next id
    customerTable.AcceptChanges()

    ' add another ten rows
    For id = 11 To 20
        customerTable.Rows.Add( _
        New Object() {id, String.Format("customer{0}",
 id)})
    Next id

    Dim expression As String
    Dim sortOrder As String

    expression = "id > 5"
    ' Sort descending by CompanyName column.
    sortOrder = "name DESC"

    ' Use the Select method to find all rows matching the filter.
    Dim foundRows As DataRow() = _
        customerTable.Select(expression, sortOrder, _
        DataViewRowState.Added)

    PrintRows(foundRows, "filtered rows")

    foundRows = customerTable.Select()
    PrintRows(foundRows, "all rows")
End Sub

Private Sub PrintRows(ByVal
 rows() As DataRow, ByVal label As
 String)
    Console.WriteLine("\n{0}", label)
    If rows.Length <= 0 Then
        Console.WriteLine("no rows found")
        Exit Sub
    End If

    Dim row As DataRow
    Dim column As DataColumn
    For Each row In rows
        For Each column In
 row.Table.Columns
            Console.Write("\table {0}", row(column))
        Next column
        Console.WriteLine()
    Next row
End Sub

C#

private static void GetRowsByFilter()
{
    DataTable customerTable = new DataTable("Customers");
    // Add columns
    customerTable.Columns.Add("id", typeof(int));
    customerTable.Columns.Add("name", typeof(string));

    // Set PrimaryKey
    customerTable.Columns[ "id" ].Unique = true;
    customerTable.PrimaryKey = new DataColumn[] 
        { customerTable.Columns["id"] };

    // Add ten rows
    for(int id=1; id<=10; id++)
    {
        customerTable.Rows.Add(
            new object[] { id, string.Format("customer{0}",
 id) });
    }
    customerTable.AcceptChanges();

    // Add another ten rows
    for(int id=11; id<=20; id++)
    {
        customerTable.Rows.Add(
            new object[] { id, string.Format("customer{0}",
 id) });
    }

    string expression;
    string sortOrder;

    expression = "id > 5";
    // Sort descending by column named CompanyName.
    sortOrder = "name DESC";
    // Use the Select method to find all rows matching the filter.
    DataRow[] foundRows = 
        customerTable.Select(expression, sortOrder, 
        DataViewRowState.Added);

    PrintRows(foundRows, "filtered rows");

    foundRows = customerTable.Select();
    PrintRows(foundRows, "all rows");
}

private static void PrintRows(DataRow[]
 rows, string label)
{
    Console.WriteLine("\n{0}", label);
    if(rows.Length <= 0)
    {
        Console.WriteLine("no rows found");
        return;
    }
    foreach(DataRow row in rows)
    {
        foreach(DataColumn column in row.Table.Columns)
        {
            Console.Write("\table {0}", row[column]);
        }
        Console.WriteLine();
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataTable クラス
DataTable メンバ
System.Data 名前空間
その他の技術情報
DataTable の作成と使用

DataTable.Select メソッド (String)

フィルタ基準と一致するすべての DataRow オブジェクトを主キーの順に (主キーがない場合は追加された順に) 配列として取得します。

名前空間: System.Data
アセンブリ: System.Data (system.data.dll 内)
構文

Visual Basic (宣言)

Public Function Select (
 _
    filterExpression As String _
) As DataRow()

Visual Basic (使用法)

Dim instance As DataTable
Dim filterExpression As String
Dim returnValue As DataRow()

returnValue = instance.Select(filterExpression)

C#

public DataRow[] Select (
    string filterExpression
)

C++

public:
array<DataRow^>^ Select (
    String^ filterExpression
)

J#

public DataRow[] Select (
    String filterExpression
)

JScript

public function Select (
    filterExpression : String
) : DataRow[]

パラメータ

filterExpression

行にフィルタをかけるために使用する基準。

戻り値
DataRow オブジェクトの配列。

解説

引数 filterExpression を作成するには、フィルタを作成するときに DataColumn クラスの Expression プロパティの値に適用する規則と同じ規則を使用します。

使用例

フィルタ式を使用して DataRow オブジェクトの配列を返す例を次に示します。

Visual Basic

Private Sub GetRowsByFilter()
    
    Dim table As DataTable = DataSet1.Tables("Orders")

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

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

    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;
    expression = "Date > '1/1/00'";
    DataRow[] foundRows;

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
DataTable クラス
DataTable メンバ
System.Data 名前空間
CaseSensitive
その他の技術情報
DataTable の作成と使用

DataTable.Select メソッド

DataRow オブジェクトの配列を取得します。
オーバーロードの一覧

名前	説明
DataTable.Select ()	すべての DataRow オブジェクトの配列を取得します。 .NET Compact Framework によってサポートされています。
DataTable.Select (String)	フィルタ基準と一致するすべての DataRow オブジェクトを主キーの順に (主キーがない場合は追加された順に) 配列として取得します。 .NET Compact Framework によってサポートされています。
DataTable.Select (String, String)	フィルタ基準と一致するすべての DataRow オブジェクトの配列を、指定した並べ替え順で取得します。 .NET Compact Framework によってサポートされています。
DataTable.Select (String, String, DataViewRowState)	フィルタ基準と一致するすべての DataRow オブジェクトの配列を、指定した状態と一致する並べ替え順に取得します。 .NET Compact Framework によってサポートされています。

参照

関連項目

DataTable クラス
DataTable メンバ
System.Data 名前空間
CaseSensitive

その他の技術情報

DataTable の作成と使用
DataTable の作成と使用

DataTable の作成と使用