Enumerable.AsEnumerable<TSource>(IEnumerable<TSource>) Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Origem:

Enumerable.cs

Retorna a entrada digitada como IEnumerable<T>.

C#

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

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IEnumerable<TSource>

A sequência a ser digitada como IEnumerable<T>.

Retornos

IEnumerable<TSource>

A sequência de entrada digitada como IEnumerable<T>.

Exemplos

O exemplo de código a seguir demonstra como usar AsEnumerable<TSource>(IEnumerable<TSource>) para ocultar o método personalizado Where de um tipo quando a implementação do operador de consulta padrão é desejada.

C#

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

Comentários

O AsEnumerable<TSource>(IEnumerable<TSource>) método não tem nenhum efeito além de alterar o tipo de tempo de compilação de source de um tipo que implementa IEnumerable<T> para IEnumerable<T> si mesmo.

AsEnumerable<TSource>(IEnumerable<TSource>) pode ser usado para escolher entre implementações de consulta quando uma sequência implementa IEnumerable<T> , mas também tem um conjunto diferente de métodos de consulta públicos disponíveis. Por exemplo, dada uma classe Table genérica que implementa e tem seus próprios métodos IEnumerable<T> , como Where, Selecte SelectMany, uma chamada para Where invocaria o método público Where de Table. Um Table tipo que representa uma tabela de banco de dados pode ter um Where método que usa o argumento de predicado como uma árvore de expressão e converte a árvore em SQL para execução remota. Se a execução remota não for desejada, por exemplo, porque o predicado invoca um método local, o AsEnumerable método pode ser usado para ocultar os métodos personalizados e, em vez disso, disponibilizar os operadores de consulta padrão.

Aplica-se a