DataTableExtensions.AsEnumerable(DataTable) Metodo

Definizione

Spazio dei nomi:

System.Data

Assembly:

System.Data.Common.dll

Source:

DataTableExtensions.cs

Restituisce un oggetto IEnumerable<T>, in cui il parametro generico T è DataRow. Questo oggetto può essere usato in un'espressione LINQ o in una query del metodo.

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)

Parametri

source

DataTable

Oggetto DataTable di origine da rendere enumerabile.

Restituisce

EnumerableRowCollection<DataRow>

Oggetto IEnumerable<T>, in cui il parametro generico T è DataRow.

Eccezioni

ArgumentNullException

L'oggetto DataTable di origine è null.

Esempio

Nell'esempio seguente il DisplayProducts metodo riceve una tabella dati contenente un oggetto DataColumn denominato ProductName, estrae i valori e quindi stampa i ProductName valori.

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

Commenti

Language-Integrated Query (LINQ) funzionano sulle origini dati che implementano l'interfaccia o l'interfaccia IEnumerable<T>IQueryable . La DataTable classe non implementa alcuna interfaccia, quindi è necessario chiamare il AsEnumerable metodo per usare come DataTable origine nella From clausola di una query LINQ. È anche possibile ottenere operatori personalizzati e specifici del dominio, ad esempio CopyToDataTable, restituendo un IEnumerable<T> oggetto.

L'oggetto enumerabile restituito dal metodo è associato definitivamente all'oggetto AsEnumerableDataTable generato. Più chiamate al AsEnumerable metodo restituiranno più oggetti querybili indipendenti associati all'origine DataTable.