Queryable.Cast<TResult>(IQueryable) Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.Queryable.dll

Origem:

Queryable.cs

Converte os elementos de um IQueryable para o tipo especificado.

public:
generic <typename TResult>
[System::Runtime::CompilerServices::Extension]
 static System::Linq::IQueryable<TResult> ^ Cast(System::Linq::IQueryable ^ source);

public static System.Linq.IQueryable<TResult> Cast<TResult> (this System.Linq.IQueryable source);

static member Cast : System.Linq.IQueryable -> System.Linq.IQueryable<'Result>

<Extension()>
Public Function Cast(Of TResult) (source As IQueryable) As IQueryable(Of TResult)

Parâmetros de tipo

TResult

O tipo para o qual os elementos de source deverão ser convertidos.

Parâmetros

source

IQueryable

O IQueryable que contém os elementos a serem convertidos.

Retornos

IQueryable<TResult>

Um IQueryable<T> que contém cada elemento da sequência de origem convertido para o tipo especificado.

Exceções

ArgumentNullException

source é null.

InvalidCastException

Um elemento na sequência não pode ser convertido para o tipo TResult.

Exemplos

O exemplo de código a seguir demonstra como usar Cast<TResult>(IQueryable) para converter objetos em uma sequência para o tipo String.

// Create a list of objects.
List<object> words =
    new List<object> { "green", "blue", "violet" };

// Cast the objects in the list to type 'string'
// and project the first letter of each string.
IEnumerable<string> query =
    words.AsQueryable()
    .Cast<string>()
    .Select(str => str.Substring(0, 1));

foreach (string s in query)
    Console.WriteLine(s);

/*  This code produces the following output:

    g
    b
    v
*/

' Create a list of objects.
Dim words As New List(Of Object)(New Object() {"green", "blue", "violet"})

' Cast the objects in the list to type 'string'
' and project the first letter of each string.
Dim query As IEnumerable(Of String) = _
    words.AsQueryable() _
            .Cast(Of String)() _
            .Select(Function(str) str.Substring(0, 1))

For Each s As String In query
    MsgBox(s)
Next

' This code produces the following output:
'
' g
' b
' v

Comentários

O Cast<TResult>(IQueryable) método gera um MethodCallExpression que representa chamar Cast<TResult>(IQueryable) a si mesmo como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o CreateQuery(Expression) método do IQueryProvider representado pela Provider propriedade do source parâmetro .

O comportamento da consulta que ocorre como resultado da execução de uma árvore de expressão que representa a chamada Cast<TResult>(IQueryable) depende da implementação do tipo do source parâmetro. O comportamento esperado é que ele converte os valores em para source o tipo TResult.