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

Tanım

Ad Alanı:

System.Linq

Bütünleştirilmiş Kod:

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>

giriş dizisi olarak IEnumerable<T>yazıldı.

Örnekler

Aşağıdaki kod örneği, standart sorgu işleci uygulaması istendiğinde bir türün özel Where yöntemini gizlemek için nasıl kullanılacağını AsEnumerable<TSource>(IEnumerable<TSource>) 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ü uygulayan IEnumerable<T>IEnumerable<T> bir türden source kendisine 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 kullanılabilir. Örneğin, uygulayan IEnumerable<T> ve , Selectve SelectManygibi Wherekendi yöntemlerine sahip olan genel bir sınıf Table verüldüğünde, öğesine Where yapılan çağrı public Where yöntemini Tableçağırır. Veritabanı Table tablosunu temsil eden bir tür, koşul bağımsız değişkenini bir Where ifade ağacı olarak alan ve ağacı uzaktan yürütme için SQL'e dönüştüren bir yönteme sahip olabilir. Örneğin, koşul yerel bir yöntemi çağırdığı için uzaktan yürütme istenmiyorsa, AsEnumerable yöntemi özel yöntemleri gizlemek ve bunun yerine standart sorgu işleçlerini kullanılabilir hale getirmek için kullanılabilir.