DataTableExtensions.AsEnumerable(DataTable) Метод

Определение

Пространство имен:

System.Data

Сборка:

System.Data.Common.dll

Исходный код:

DataTableExtensions.cs

Возвращает объект IEnumerable<T>, где универсальный параметр T имеет значение DataRow. Этот объект можно использовать в запросе выражения или метода LINQ.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Data::EnumerableRowCollection<System::Data::DataRow ^> ^ AsEnumerable(System::Data::DataTable ^ source);

public static System.Data.EnumerableRowCollection<System.Data.DataRow> AsEnumerable (this System.Data.DataTable source);

static member AsEnumerable : System.Data.DataTable -> System.Data.EnumerableRowCollection<System.Data.DataRow>

<Extension()>
Public Function AsEnumerable (source As DataTable) As EnumerableRowCollection(Of DataRow)

Параметры

source

DataTable

Исходный объект DataTable, который требуется сделать перечисляемым.

Возвращаемое значение

EnumerableRowCollection<DataRow>

Объект IEnumerable<T>, где универсальный параметр T имеет значение DataRow.

Исключения

ArgumentNullException

Исходный объект DataTable имеет значение null.

Примеры

В следующем примере метод получает dataTable, DisplayProducts содержащий объект DataColumn с именем ProductName, извлекает ProductName значения, а затем выводит их на печать.

using System;
using System.Data;

class Program {
   public void DisplayProducts(DataTable table) {
      var productNames = from products in table.AsEnumerable() select products.Field<string>("ProductName");
      Console.WriteLine("Product Names: ");
      foreach (string productName in productNames) {
         Console.WriteLine(productName);
      }
   }

   static void Main(string[] args) {
      DataTable table = new DataTable();
      table.Columns.Add("ID");
      table.Columns.Add("ProductName");

      table.Rows.Add("1", "Chai");
      table.Rows.Add("2", "Queso Cabrales");
      table.Rows.Add("3", "Tofu");

      Program inst = new Program();
      inst.DisplayProducts(table);
   }
}

Imports System.Console

Module Module1
   Public Sub DisplayProducts(ByVal table As DataTable)
      Dim productNames = From products In table.AsEnumerable() Select products("ProductName")
      WriteLine("Product Names: ")
      For Each productName In productNames
         WriteLine(productName)
       Next
   End Sub

   Sub Main()
      Dim table As DataTable = New DataTable()
      table.Columns.Add("ID")
      table.Columns.Add("ProductName")

      table.Rows.Add("1", "Chai")
      table.Rows.Add("2", "Queso Cabrales")
      table.Rows.Add("3", "Tofu")

      DisplayProducts(table)
   End Sub
End Module

Комментарии

запросы Language-Integrated (LINQ) работают с источниками данных, реализующими IEnumerable<T> интерфейс или IQueryable интерфейс . Класс DataTable не реализует ни один из интерфейсов, поэтому необходимо вызвать AsEnumerable метод , чтобы использовать DataTable в качестве источника в From предложении запроса LINQ. Вы также можете получить пользовательские операторы, относящиеся к предметной области, например CopyToDataTable, возвращая IEnumerable<T> объект .

Перечисляемый объект, возвращаемый методом AsEnumerable , постоянно привязывается к объекту DataTable , который его создал. Несколько вызовов метода возвращают несколько независимых объектов, доступных для AsEnumerable запросов, которые привязаны к источнику DataTable.