Enumerable.AsEnumerable<TSource>(IEnumerable<TSource>) Metoda

Definice

Vrátí vstup zadaný jako IEnumerable<T>.

public static System.Collections.Generic.IEnumerable<TSource> AsEnumerable<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

Parametry typu

TSource

Typ elementů .source

Parametry

source
IEnumerable<TSource>

Sekvence, která se má zadat jako IEnumerable<T>.

Návraty

IEnumerable<TSource>

Vstupní sekvence s typem IEnumerable<T>.

Příklady

Následující příklad kódu ukazuje, jak použít AsEnumerable<TSource>(IEnumerable<TSource>) ke skrytí vlastní Where metody typu, když je požadovaná implementace standardního operátoru dotazu.

// Custom class.
class Clump<T> : List<T>
{
    // Custom implementation of Where().
    public IEnumerable<T> Where(Func<T, bool> predicate)
    {
        Console.WriteLine("In Clump's implementation of Where().");
        return Enumerable.Where(this, predicate);
    }
}

static void AsEnumerableEx1()
{
    // Create a new Clump<T> object.
    Clump<string> fruitClump =
        new Clump<string> { "apple", "passionfruit", "banana",
            "mango", "orange", "blueberry", "grape", "strawberry" };

    // First call to Where():
    // Call Clump's Where() method with a predicate.
    IEnumerable<string> query1 =
        fruitClump.Where(fruit => fruit.Contains("o"));

    Console.WriteLine("query1 has been created.\n");

    // Second call to Where():
    // First call AsEnumerable() to hide Clump's Where() method and thereby
    // force System.Linq.Enumerable's Where() method to be called.
    IEnumerable<string> query2 =
        fruitClump.AsEnumerable().Where(fruit => fruit.Contains("o"));

    // Display the output.
    Console.WriteLine("query2 has been created.");
}

// This code produces the following output:
//
// In Clump's implementation of Where().
// query1 has been created.
//
// query2 has been created.

Poznámky

Metoda AsEnumerable<TSource>(IEnumerable<TSource>) nemá žádný jiný účinek, než změnit typ source kompilace z typu, který implementuje IEnumerable<T> do IEnumerable<T> sebe.

AsEnumerable<TSource>(IEnumerable<TSource>) Lze použít k výběru mezi implementacemi dotazů, když se sekvence implementuje IEnumerable<T> , ale má také k dispozici jinou sadu metod veřejného dotazu. Například v případě obecné třídyTable, která implementuje IEnumerable<T> a má své vlastní metody, jako Wherejsou , Selecta SelectMany, by volání Where vyvolá veřejnou Where metodu .Table Table Typ, který představuje tabulku databáze, může mít metoduWhere, která převezme argument predikátu jako strom výrazu a převede strom na SQL pro vzdálené spuštění. Pokud vzdálené spuštění není žádoucí, například proto, že predikát vyvolá místní metodu, lze metodu AsEnumerable použít ke skrytí vlastních metod a místo toho zpřístupnění standardních operátorů dotazu.

Platí pro

Produkt Verze
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0