Enumerable.ElementAt Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
ElementAt<TSource>(IEnumerable<TSource>, Index) |
Devuelve el elemento situado en un índice especificado de una secuencia. |
ElementAt<TSource>(IEnumerable<TSource>, Int32) |
Devuelve el elemento situado en un índice especificado de una secuencia. |
ElementAt<TSource>(IEnumerable<TSource>, Index)
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
Devuelve el elemento situado en un índice especificado de una secuencia.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource ElementAt(System::Collections::Generic::IEnumerable<TSource> ^ source, Index index);
public static TSource ElementAt<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Index index);
static member ElementAt : seq<'Source> * Index -> 'Source
<Extension()>
Public Function ElementAt(Of TSource) (source As IEnumerable(Of TSource), index As Index) As TSource
Parámetros de tipo
- TSource
Tipo de los elementos de source
.
Parámetros
- source
- IEnumerable<TSource>
IEnumerable<T> del que se va a devolver un elemento.
- index
- Index
Índice del elemento que se va a recuperar, que es desde el principio o el final de la secuencia.
Devoluciones
Elemento situado en la posición especificada de la source
secuencia.
Excepciones
source
es null
.
index
está fuera de los límites de la source
secuencia.
Comentarios
Si el tipo de source
implementa IList<T>, esa implementación se usa para obtener el elemento en el índice especificado. De lo contrario, este método obtiene el elemento especificado.
Este método produce una excepción si index
está fuera del intervalo. Para devolver en su lugar un valor predeterminado cuando el índice especificado está fuera del intervalo, use el ElementAtOrDefault método .
Se aplica a
ElementAt<TSource>(IEnumerable<TSource>, Int32)
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
- Source:
- ElementAt.cs
Devuelve el elemento situado en un índice especificado de una secuencia.
public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
static TSource ElementAt(System::Collections::Generic::IEnumerable<TSource> ^ source, int index);
public static TSource ElementAt<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int index);
static member ElementAt : seq<'Source> * int -> 'Source
<Extension()>
Public Function ElementAt(Of TSource) (source As IEnumerable(Of TSource), index As Integer) As TSource
Parámetros de tipo
- TSource
Tipo de los elementos de source
.
Parámetros
- source
- IEnumerable<TSource>
IEnumerable<T> del que se va a devolver un elemento.
- index
- Int32
Índice de base cero del elemento que se debe recuperar.
Devoluciones
El elemento situado en la posición especificada de la secuencia de origen.
Excepciones
source
es null
.
index
es menor que 0 o mayor o igual que el número de elementos de source
.
Ejemplos
En el ejemplo de código siguiente se muestra cómo usar ElementAt para devolver un elemento en una posición específica.
string[] names =
{ "Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow",
"Hedlund, Magnus", "Ito, Shu" };
Random random = new Random(DateTime.Now.Millisecond);
string name = names.ElementAt(random.Next(0, names.Length));
Console.WriteLine("The name chosen at random is '{0}'.", name);
/*
This code produces output similar to the following:
The name chosen at random is 'Ito, Shu'.
*/
' Create an array of strings.
Dim names() As String =
{"Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow", "Hedlund, Magnus", "Ito, Shu"}
Dim random As Random = New Random(DateTime.Now.Millisecond)
' Get a string at a random index within the array.
Dim name As String = names.ElementAt(random.Next(0, names.Length))
' Display the output.
Console.WriteLine($"The name chosen at random is {name}")
' This code produces output similar to the following:
'
' The name chosen at random is Ito, Shu
Comentarios
Si el tipo de source
implementa IList<T>, esa implementación se usa para obtener el elemento en el índice especificado. De lo contrario, este método obtiene el elemento especificado.
Este método produce una excepción si index
está fuera del intervalo. Para devolver en su lugar un valor predeterminado cuando el índice especificado está fuera del intervalo, use el ElementAtOrDefault método .