DataTableExtensions.AsEnumerable(DataTable) Methode

Definition

Gibt ein IEnumerable<T>-Objekt zurück, bei dem der generische Parameter T gleich DataRow ist.Returns an IEnumerable<T> object, where the generic parameter T is DataRow. Dieses Objekt kann in einem LINQLINQ-Ausdruck oder einer Methodenabfrage verwendet werden.This object can be used in a LINQLINQ expression or method query.

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)

Parameter

source
DataTable

Die Quell-DataTable, die als aufzählbar festgelegt werden soll.The source DataTable to make enumerable.

Gibt zurück

Ein IEnumerable<T>-Objekt bei dem der generische Parameter T den Wert DataRow hat.An IEnumerable<T> object, where the generic parameter T is DataRow.

Ausnahmen

Die Quell DataTable ist null.The source DataTable is null.

Beispiele

Im folgenden Beispiel erhält die DisplayProducts-Methode eine Datentabelle, die eine datacolenn mit dem Namen ProductName enthält, die ProductName-Werte extrahiert und dann die Werte ausgibt.In the following sample, the DisplayProducts method receives a DataTable that contains a DataColumn named ProductName, extracts the ProductName values and then prints the values.

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

Hinweise

Language-Integrated Query (LINQ)Language-Integrated Query (LINQ)-Abfragen arbeiten mit Datenquellen, die die IEnumerable<T>-Schnittstelle oder die IQueryable-Schnittstelle implementieren.queries work on data sources that implement the IEnumerable<T> interface or the IQueryable interface. Die DataTable-Klasse implementiert keine der beiden Schnittstellen, daher müssen Sie die AsEnumerable-Methode zum Verwenden von DataTable als Quelle in der From-Klausel einer LINQLINQ-Abfrage verwenden.The DataTable class does not implement either interface, so you must call the AsEnumerable method to use the DataTable as a source in the From clause of a LINQLINQ query. Sie können auch benutzerdefinierte, domänenspezifische Operatoren (z. b. CopyToDataTable) abrufen, indem Sie ein IEnumerable<T>-Objekt zurückgeben.You can also obtain custom, domain-specific operators, such as CopyToDataTable, by returning an IEnumerable<T> object.

Das Aufzähl Bare Objekt, das von der AsEnumerable-Methode zurückgegeben wird, ist dauerhaft an den DataTable gebunden, der es erstellt hat.The enumerable object returned by the AsEnumerable method is permanently bound to the DataTable that produced it. Mehrere Aufrufe der AsEnumerable-Methode geben mehrere unabhängige abfragbare Objekte zurück, die alle an die Quelle gebunden sind DataTable.Multiple calls to the AsEnumerable method will return multiple, independent queryable objects that are all bound to the source DataTable.

Gilt für: