Queryable.ElementAt Método

  • Referência

Definição

Namespace:
System.Linq
Assembly:
System.Linq.Queryable.dll
Assembly:
System.Core.dll
Assembly:
netstandard.dll

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

TSource

O elemento na posição especificada na source sequência.

Exceções

ArgumentNullException

source é null.

ArgumentOutOfRangeException

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

TSource

O elemento na posição especificada em source.

Exceções

ArgumentNullException

source é null.

ArgumentOutOfRangeException

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.

Aplica-se a