Enumerable.ElementAtOrDefault(IEnumerable<TSource>, Int32) Enumerable.ElementAtOrDefault(IEnumerable<TSource>, Int32) Enumerable.ElementAtOrDefault(IEnumerable<TSource>, Int32) Enumerable.ElementAtOrDefault(IEnumerable<TSource>, Int32) Method

Definizione

Restituisce l'elemento in corrispondenza di un indice specificato in una sequenza o un valore predefinito se l'indice è esterno all'intervallo.Returns the element at a specified index in a sequence or a default value if the index is out of range.

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

Parametri di tipo

TSource

Tipo degli elementi di source.The type of the elements of source.

Parametri

source
IEnumerable<TSource>

Un IEnumerable<T> dal quale restituire un elemento.An IEnumerable<T> to return an element from.

index
Int32 Int32 Int32 Int32

Indice in base zero dell'elemento da recuperare.The zero-based index of the element to retrieve.

Restituisce

TSource TSource TSource TSource

default(TSource) se l'indice è esterno ai limiti della sequenza di origine; in caso contrario, l'elemento in corrispondenza della posizione specificata nella sequenza di origine.default(TSource) if the index is outside the bounds of the source sequence; otherwise, the element at the specified position in the source sequence.

Eccezioni

Esempi

Nell'esempio di codice seguente viene illustrato come utilizzare ElementAtOrDefault.The following code example demonstrates how to use ElementAtOrDefault. Questo esempio Usa un indice che non rientra nei limiti della matrice.This example uses an index that is outside the bounds of the array.

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.
MsgBox("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]

Commenti

Se il tipo della source implementa IList<T>, tale implementazione viene utilizzata per ottenere l'elemento in corrispondenza dell'indice specificato.If the type of source implements IList<T>, that implementation is used to obtain the element at the specified index. In caso contrario, questo metodo ottiene l'elemento specificato.Otherwise, this method obtains the specified element.

Il valore predefinito per riferimento e i tipi nullable è null.The default value for reference and nullable types is null.

Si applica a