DataTableExtensions.AsEnumerable(DataTable) Metoda

Definicja

Przestrzeń nazw:

System.Data

Zestaw:

System.Data.Common.dll

Źródło:

DataTableExtensions.cs

IEnumerable<T> Zwraca obiekt, w którym parametr T ogólny to DataRow. Ten obiekt może być używany w wyrażeniu LINQ lub zapytaniu metody.

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)

Parametry

source

DataTable

Źródło DataTable do wyliczenia.

Zwraca

EnumerableRowCollection<DataRow>

Obiekt IEnumerable<T> , w którym parametr T ogólny to DataRow.

Wyjątki

ArgumentNullException

DataTable Źródłem jest null.

Przykłady

W poniższym przykładzie DisplayProducts metoda odbiera tabelę DataTable zawierającą kolumnę DataColumn o nazwie ProductName, wyodrębnia wartości, a następnie drukuje ProductName wartości.

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

Uwagi

zapytania Language-Integrated Query (LINQ) działają na źródłach danych, które implementują IEnumerable<T> interfejs lub IQueryable interfejs. Klasa DataTable nie implementuje interfejsu, dlatego należy wywołać AsEnumerable metodę , aby użyć DataTable metody jako źródła w From klauzuli zapytania LINQ. Można również uzyskać niestandardowe, specyficzne dla domeny operatory, takie jak CopyToDataTable, zwracając IEnumerable<T> obiekt.

Obiekt wyliczalny zwrócony przez metodę AsEnumerable jest trwale powiązany z utworzonym obiektem DataTable . Wiele wywołań metody AsEnumerable zwróci wiele niezależnych obiektów, które są powiązane ze źródłem DataTable.