DataTable.Select 方法

定义

命名空间:

System.Data

程序集:

netstandard.dll, System.Data.Common.dll

获取对象的数组 DataRow 。

重载

名称	说明
Select()	获取所有 DataRow 对象的数组。
Select(String)	获取与筛选条件匹配的所有 DataRow 对象的数组。
Select(String, String)	获取与筛选条件匹配的所有 DataRow 对象的数组（按指定的排序顺序）。
Select(String, String, DataViewRowState)	获取与筛选器匹配的所有 DataRow 对象的数组，这些对象按与指定状态匹配的排序顺序。

Select()

Source:

DataTable.cs

获取所有 DataRow 对象的数组。

public:
 cli::array <System::Data::DataRow ^> ^ Select();

public System.Data.DataRow[] Select();

member this.Select : unit -> System.Data.DataRow[]

Public Function Select () As DataRow()

返回

DataRow[]

一个 DataRow 对象数组。

示例

以下示例通过Select该方法返回对象数组DataRow。

private void GetRows()
{
    // Get the DataTable of a DataSet.
    DataTable table = DataSet1.Tables["Suppliers"];
    DataRow[] rows = table.Select();

    // Print the value one column of each DataRow.
    for(int i = 0; i < rows.Length ; i++)
    {
        Console.WriteLine(rows[i]["CompanyName"]);
    }
}

Private Sub GetRows()
    ' Get the DataTable of a DataSet.
    Dim table As DataTable = DataSet1.Tables("Suppliers")
    Dim rows() As DataRow = table.Select()

    Dim i As Integer
    ' Print the value one column of each DataRow.
    For i = 0 to rows.GetUpperBound(0)
       Console.WriteLine(rows(i)("CompanyName"))
    Next i
End Sub

注解

若要确保正确的排序顺序，请使用或Select(String, String, DataViewRowState)指定排序条件Select(String, String)。

另请参阅

• CaseSensitive
• DataTables
• Null 值

Select(String)

Source:

DataTable.cs

获取与筛选条件匹配的所有 DataRow 对象的数组。

public:
 cli::array <System::Data::DataRow ^> ^ Select(System::String ^ filterExpression);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members of types used in the filter expression might be trimmed.")]
public System.Data.DataRow[] Select(string? filterExpression);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members of types used in the filter expression might be trimmed.")>]
member this.Select : string -> System.Data.DataRow[]

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

参数

filterExpression

String

用于筛选行的条件。

返回

DataRow[]

一个 DataRow 对象数组。

属性

RequiresUnreferencedCodeAttribute

示例

以下示例使用筛选器表达式返回对象数组 DataRow 。

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]);
    }
}

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

注解

若要创建 filterExpression 参数，请使用应用于 DataColumn 类 Expression 属性值的相同规则来创建筛选器。

若要确保正确的排序顺序，请使用或Select(String, String, DataViewRowState)指定排序条件Select(String, String)。

如果筛选器上的列包含 null 值，则它不会是结果的一部分。

另请参阅

• CaseSensitive
• DataTables
• Null 值

Select(String, String)

Source:

DataTable.cs

获取与筛选条件匹配的所有 DataRow 对象的数组（按指定的排序顺序）。

public:
 cli::array <System::Data::DataRow ^> ^ Select(System::String ^ filterExpression, System::String ^ sort);

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members of types used in the filter expression might be trimmed.")]
public System.Data.DataRow[] Select(string? filterExpression, string? sort);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members of types used in the filter expression might be trimmed.")>]
member this.Select : string * string -> System.Data.DataRow[]

Public Function Select (filterExpression As String, sort As String) As DataRow()

参数

filterExpression

String

用于筛选行的条件。

sort

String

指定列和排序方向的字符串。

返回

DataRow[]

与筛选器表达式匹配的对象数组 DataRow 。

属性

RequiresUnreferencedCodeAttribute

示例

以下示例使用筛选器表达式返回对象数组 DataRow 。

using System;
using System.Data;

public class A {

   public static void Main() {
      DataTable table = new DataTable("Orders");
      table.Columns.Add("OrderID", typeof(Int32));
      table.Columns.Add("OrderQuantity", typeof(Int32));
      table.Columns.Add("CompanyName", typeof(string));
      table.Columns.Add("Date", typeof(DateTime));

      DataRow newRow = table.NewRow();
      newRow["OrderID"] = 1;
      newRow["OrderQuantity"] = 3;
      newRow["CompanyName"] = "NewCompanyName";
      newRow["Date"] = "1979, 1, 31";

      // Add the row to the rows collection.
      table.Rows.Add(newRow);

      DataRow newRow2 = table.NewRow();
      newRow2["OrderID"] = 2;
      newRow2["OrderQuantity"] = 2;
      newRow2["CompanyName"] = "NewCompanyName1";
      table.Rows.Add(newRow2);

      DataRow newRow3 = table.NewRow();
      newRow3["OrderID"] = 3;
      newRow3["OrderQuantity"] = 2;
      newRow3["CompanyName"] = "NewCompanyName2";
      table.Rows.Add(newRow3);

      // Presuming the DataTable has a column named Date.
      string expression = "Date = '1/31/1979' or OrderID = 2";
      // string expression = "OrderQuantity = 2 and OrderID = 2";

      // Sort descending by column named CompanyName.
      string sortOrder = "CompanyName ASC";
      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][2]);
   }
}

Imports System.Data

Public Class A

   Public Shared Sub Main()
      Dim table As New DataTable("Orders")
      table.Columns.Add("OrderID", GetType(Int32))
      table.Columns.Add("OrderQuantity", GetType(Int32))
      table.Columns.Add("CompanyName", GetType(String))
      table.Columns.Add("Date", GetType(DateTime))

      Dim newRow As DataRow = table.NewRow()
      newRow("OrderID") = 1
      newRow("OrderQuantity") = 3
      newRow("CompanyName") = "NewCompanyName"
      newRow("Date") = "1979, 1, 31"

      ' Add the row to the rows collection.
      table.Rows.Add(newRow)

      Dim newRow2 As DataRow = table.NewRow()
      newRow2("OrderID") = 2
      newRow2("OrderQuantity") = 2
      newRow2("CompanyName") = "NewCompanyName1"
      table.Rows.Add(newRow2)

      Dim newRow3 As DataRow = table.NewRow()
      newRow3("OrderID") = 3
      newRow3("OrderQuantity") = 2
      newRow3("CompanyName") = "NewCompanyName2"
      table.Rows.Add(newRow3)

      ' Presuming the DataTable has a column named Date.
      Dim expression As String = "Date = '1/31/1979' or OrderID = 2"
      ' Dim expression As String = "OrderQuantity = 2 and OrderID = 2"

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

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

      ' Print column 0 of each returned row.
      For i As Integer = 0 To foundRows.Length - 1
         Console.WriteLine(foundRows(i)(2))
      Next
   End Sub
End Class

注解

若要形成 filterExpression 参数，请使用相同的规则来创建 DataColumn 类的 Expression 属性值。 该 Sort 参数还使用相同的规则来创建类的 Expression 字符串。

如果筛选器上的列包含 null 值，则它不会是结果的一部分。

另请参阅

• CaseSensitive
• DataTables
• Null 值

Select(String, String, DataViewRowState)

Source:

DataTable.cs

获取与筛选器匹配的所有 DataRow 对象的数组，这些对象按与指定状态匹配的排序顺序。

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

[System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members of types used in the filter expression might be trimmed.")]
public System.Data.DataRow[] Select(string? filterExpression, string? sort, System.Data.DataViewRowState recordStates);

[<System.Diagnostics.CodeAnalysis.RequiresUnreferencedCode("Members of types used in the filter expression might be trimmed.")>]
member this.Select : string * string * System.Data.DataViewRowState -> System.Data.DataRow[]

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

参数

filterExpression

String

用于筛选行的条件。

sort

String

指定列和排序方向的字符串。

recordStates

DataViewRowState

其中一个 DataViewRowState 值。

返回

DataRow[]

一个 DataRow 对象数组。

属性

RequiresUnreferencedCodeAttribute

示例

以下示例使用筛选器表达式和记录状态返回对象数组 DataRow 。

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();
    }
}

Private Sub GetRowsByFilter()

    Dim customerTable As 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

注解

若要形成 filterExpression 参数，请使用相同的规则来创建 DataColumn 类的 Expression 属性值。 该 Sort 参数还使用相同的规则来创建类的 Expression 字符串。

如果筛选器上的列包含 null 值，则它不会是结果的一部分。

另请参阅

• DataTables
• Null 值