Queryable.ElementAt Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Sobrecargas
ElementAt<TSource>(IQueryable<TSource>, Index) |
Retorna o elemento de um índice especificado em uma sequência. |
ElementAt<TSource>(IQueryable<TSource>, Int32) |
Retorna o elemento de um índice especificado em uma sequência. |
ElementAt<TSource>(IQueryable<TSource>, Index)
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
Retorna o elemento de um índice especificado em uma sequência.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource ElementAt(System::Linq::IQueryable<TSource> ^ source, Index index);
public static TSource ElementAt<TSource> (this System.Linq.IQueryable<TSource> source, Index index);
static member ElementAt : System.Linq.IQueryable<'Source> * Index -> 'Source
<Extension()>
Public Function ElementAt(Of TSource) (source As IQueryable(Of TSource), index As Index) As TSource
Parâmetros de tipo
- TSource
O tipo dos elementos de source
.
Parâmetros
- source
- IQueryable<TSource>
Um IQueryable<T> do qual um elemento será retornado.
- index
- Index
O índice do elemento a ser recuperado, que é do início ou do final.
Retornos
O elemento na posição especificada na source
sequência.
Exceções
source
é null
.
index
está fora dos limites da source
sequência.
Aplica-se a
ElementAt<TSource>(IQueryable<TSource>, Int32)
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
- Origem:
- Queryable.cs
Retorna o elemento de um índice especificado em uma sequência.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource ElementAt(System::Linq::IQueryable<TSource> ^ source, int index);
public static TSource ElementAt<TSource> (this System.Linq.IQueryable<TSource> source, int index);
static member ElementAt : System.Linq.IQueryable<'Source> * int -> 'Source
<Extension()>
Public Function ElementAt(Of TSource) (source As IQueryable(Of TSource), index As Integer) As TSource
Parâmetros de tipo
- TSource
O tipo dos elementos de source
.
Parâmetros
- source
- IQueryable<TSource>
Um IQueryable<T> do qual um elemento será retornado.
- index
- Int32
O índice baseado em zero do elemento a ser recuperado.
Retornos
O elemento na posição especificada em source
.
Exceções
source
é null
.
index
é menor que zero.
Exemplos
O exemplo de código a seguir demonstra como usar ElementAt<TSource>(IQueryable<TSource>, Int32) para retornar um elemento em uma posição específica em uma sequência.
string[] names = { "Hartono, Tommy", "Adams, Terry",
"Andersen, Henriette Thaulow",
"Hedlund, Magnus", "Ito, Shu" };
Random random = new Random(DateTime.Now.Millisecond);
string name =
names.AsQueryable().ElementAt(random.Next(0, names.Length));
Console.WriteLine("The name chosen at random is '{0}'.", name);
/*
This code produces the following sample output.
Yours may be different due to the use of Random.
The name chosen at random is 'Ito, Shu'.
*/
Dim names() As String = {"Hartono, Tommy", "Adams, Terry", _
"Andersen, Henriette Thaulow", _
"Hedlund, Magnus", "Ito, Shu"}
Dim rand As New Random(DateTime.Now.Millisecond)
Dim name As String = _
names.AsQueryable().ElementAt(rand.Next(0, names.Length))
MsgBox(String.Format("The name chosen at random is '{0}'.", name))
' This code produces the following sample output.
' Yours may be different due to the use of Random.
'
' The name chosen at random is 'Ito, Shu'.
Comentários
O ElementAt<TSource>(IQueryable<TSource>, Int32) método gera um MethodCallExpression que representa a própria chamada ElementAt<TSource>(IQueryable<TSource>, Int32) como um método genérico construído. Em seguida, ele passa o MethodCallExpression para o Execute<TResult>(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 ElementAt<TSource>(IQueryable<TSource>, Int32) depende da implementação do tipo do source
parâmetro. O comportamento esperado é que ele retorna o item na posição index
em source
.