Enumerable.AsEnumerable<TSource>(IEnumerable<TSource>) Yöntem

Tanım

Ad Alanı:

System.Linq

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Linq.dll

Kaynak:

Enumerable.cs

olarak IEnumerable<T>yazılan girişi döndürür.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static System::Collections::Generic::IEnumerable<TSource> ^ AsEnumerable(System::Collections::Generic::IEnumerable<TSource> ^ source);

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

static member AsEnumerable : seq<'Source> -> seq<'Source>

<Extension()>
Public Function AsEnumerable(Of TSource) (source As IEnumerable(Of TSource)) As IEnumerable(Of TSource)

Tür Parametreleri

TSource

öğelerinin sourcetürü.

Parametreler

source

IEnumerable<TSource>

olarak IEnumerable<T>yazacak sıra.

Döndürülenler

IEnumerable<TSource>

Olarak yazılan IEnumerable<T>giriş dizisi.

Örnekler

Aşağıdaki kod örneği, standart sorgu işleci uygulaması istendiğinde bir türün özel AsEnumerable<TSource>(IEnumerable<TSource>) yöntemini gizlemek için nasıl kullanılacağını Where gösterir.

// 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.

Dim output As New System.Text.StringBuilder

' A custom class.
Class Clump(Of T)
    Inherits List(Of T)

    ' Constructor.
    Public Sub New(ByVal collection As IEnumerable(Of T))
        MyBase.New(collection)
    End Sub

    ' Custom implementation of Where().
    Function Where(ByVal predicate As Func(Of T, Boolean)) As IEnumerable(Of T)
        output.AppendLine("In Clump's implementation of Where().")
        Return Enumerable.Where(Me, predicate)
    End Function
End Class

Sub AsEnumerableEx1()
    ' Create a new Clump(Of T) object.
    Dim fruitClump As New Clump(Of String)(New String() _
                                       {"apple", "passionfruit", "banana",
                                        "mango", "orange", "blueberry",
                                        "grape", "strawberry"})

    ' First call to Where():
    ' Call Clump's Where() method with a predicate.
    Dim query1 As IEnumerable(Of String) =
    fruitClump.Where(Function(fruit) fruit.Contains("o"))
    output.AppendLine("query1 has been created." & vbCrLf)

    ' 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.
    Dim query2 As IEnumerable(Of String) =
    fruitClump.AsEnumerable().Where(Function(fruit) fruit.Contains("o"))
    output.AppendLine("query2 has been created.")

    ' Display the output.
    Console.WriteLine(output.ToString())
End Sub

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

Açıklamalar

yönteminin AsEnumerable<TSource>(IEnumerable<TSource>) derleme zamanı türünü, kendisini uygulayan sourceIEnumerable<T> bir türden IEnumerable<T> değiştirmek dışında bir etkisi yoktur.

AsEnumerable<TSource>(IEnumerable<TSource>) bir dizi uygulandığında IEnumerable<T> sorgu uygulamaları arasında seçim yapmak için kullanılabilir ancak aynı zamanda farklı bir genel sorgu yöntemleri kümesi de kullanılabilir. Örneğin, uygulayan Table ve , IEnumerable<T>ve Wheregibi Selectkendi yöntemlerine sahip olan genel bir sınıf SelectMany verüldüğünde, çağrısı Where genel Where yöntemini Tableçağırır. Veritabanı Table tablosunu temsil eden bir tür, koşul bağımsız değişkenini bir ifade ağacı olarak alan ve ağacı uzaktan yürütme için SQL'e dönüştüren bir yönteme sahip Where olabilir. Örneğin koşul yerel bir yöntemi çağırdığı için uzaktan yürütme istenmiyorsa, AsEnumerable yöntem özel yöntemleri gizlemek ve bunun yerine standart sorgu işleçlerini kullanılabilir hale getirmek için kullanılabilir.