Enumerable.ElementAtOrDefault Método

Definição

Namespace:

System.Linq

Assembly:

System.Linq.dll

Sobrecargas

ElementAtOrDefault<TSource>(IEnumerable<TSource>, Index)	Retorna o elemento em um índice especificado em uma sequência ou um valor padrão se o índice estiver fora do intervalo.
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32)	Retorna o elemento em um índice especificado em uma sequência ou um valor padrão se o índice estiver fora do intervalo.

ElementAtOrDefault<TSource>(IEnumerable<TSource>, Index)

Origem:

ElementAt.cs

Retorna o elemento em um índice especificado em uma sequência ou um valor padrão se o índice estiver fora do intervalo.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource ElementAtOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Index index);

public static TSource? ElementAtOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Index index);

static member ElementAtOrDefault : seq<'Source> * Index -> 'Source

<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IEnumerable(Of TSource), index As Index) As TSource

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> do qual um elemento será retornado.

index

Index

O índice do elemento a ser recuperado, que é desde o início ou o final da sequência.

Retornos

TSource

default se index estiver fora dos limites da source sequência; caso contrário, o elemento na posição especificada na source sequência.

Exceções

ArgumentNullException

source é null.

Comentários

Se o tipo de source implementa IList<T>, essa implementação será usada para obter o elemento no índice especificado. Caso contrário, esse método obtém o elemento especificado.

O valor padrão para tipos de referência e anuláveis é null.

ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32)

Origem:

ElementAt.cs

Retorna o elemento em um índice especificado em uma sequência ou um valor padrão se o índice estiver fora do intervalo.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource ElementAtOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, int index);

public static TSource? ElementAtOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int index);

static member ElementAtOrDefault : seq<'Source> * int -> 'Source

<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IEnumerable(Of TSource), index As Integer) As TSource

Parâmetros de tipo

TSource

O tipo dos elementos de source.

Parâmetros

source

IEnumerable<TSource>

Um IEnumerable<T> do qual um elemento será retornado.

index

Int32

O índice baseado em zero do elemento a ser recuperado.

Retornos

TSource

default(TSource) se o índice estiver fora dos limites da sequência de origem; caso contrário, o elemento na posição especificada na sequência de origem.

Exceções

ArgumentNullException

source é null.

Exemplos

O exemplo de código a seguir demonstra como usar ElementAtOrDefault. Este exemplo usa um índice que está fora dos limites da matriz.

string[] names =
    { "Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow",
        "Hedlund, Magnus", "Ito, Shu" };

int index = 20;

string name = names.ElementAtOrDefault(index);

Console.WriteLine(
    "The name chosen at index {0} is '{1}'.",
    index,
    String.IsNullOrEmpty(name) ? "<no name at this index>" : name);

/*
 This code produces the following output:

 The name chosen at index 20 is '<no name at this index>'.
*/

' Create an array of strings.
Dim names() As String =
{"Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow", "Hedlund, Magnus", "Ito, Shu"}

Dim index As Integer = 20

' Get a string at an index that is out of range in the array.
Dim name As String = names.ElementAtOrDefault(index)

Dim text As String = If(String.IsNullOrEmpty(name), "[THERE IS NO NAME AT THIS INDEX]", name)

' Display the output.
Console.WriteLine($"The name chosen at index {index} is {text}")

' This code produces the following output:
'
' The name chosen at index 20 is [THERE IS NO NAME AT THIS INDEX]

Comentários

Se o tipo de source implementa IList<T>, essa implementação será usada para obter o elemento no índice especificado. Caso contrário, esse método obtém o elemento especificado.

O valor padrão para tipos de referência e anuláveis é null.