DataTableExtensions.AsEnumerable(DataTable) Método

Definição

Namespace:

System.Data

Assembly:

System.Data.Common.dll

Origem:

DataTableExtensions.cs

Retorna um objeto IEnumerable<T> em que o parâmetro genérico T é DataRow. Esse objeto pode ser usado em uma expressão LINQ ou consulta de método.

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)

Parâmetros

source

DataTable

A origem DataTable a ser tornada enumerável.

Retornos

EnumerableRowCollection<DataRow>

Um objeto IEnumerable<T> em que o parâmetro genérico T é DataRow.

Exceções

ArgumentNullException

A fonte de DataTable é null.

Exemplos

No exemplo a seguir, o DisplayProducts método recebe uma DataTable que contém um DataColumn chamado ProductName, extrai os ProductName valores e, em seguida, imprime os valores.

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

Comentários

as consultas LINQ (consulta Language-Integrated) funcionam em fontes de dados que implementam a IEnumerable<T> interface ou a IQueryable interface. A DataTable classe não implementa nenhuma das interfaces, portanto, você deve chamar o AsEnumerable método para usar o DataTable como uma origem From na cláusula de uma consulta LINQ. Você também pode obter operadores personalizados e específicos do domínio, como CopyToDataTable, retornando um IEnumerable<T> objeto .

O objeto enumerável retornado pelo AsEnumerable método é permanentemente associado ao que o DataTable produziu. Várias chamadas para o AsEnumerable método retornarão vários objetos consultáveis independentes que estão todos associados à origem DataTable.