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

Definition

Gibt das Element an einem angegebenen Index in einer Sequenz oder einen Standardwert zurück, wenn der Index außerhalb des gültigen Bereichs liegt.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

Typparameter

TSource

Der Typ der Elemente von source.The type of the elements of source.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, aus dem ein Element zurückgegeben werden sollAn IEnumerable<T> to return an element from.

index
Int32

Der auf 0 (null) basierende Index des abzurufenden Elements.The zero-based index of the element to retrieve.

Gibt zurück

TSource

default(TSource), wenn der Index außerhalb der Begrenzungen der Quellsequenz liegt, andernfalls das Element an der angegebenen Position in der Quellsequenzdefault(TSource) if the index is outside the bounds of the source sequence; otherwise, the element at the specified position in the source sequence.

Ausnahmen

source ist nullsource is null.

Beispiele

Das folgende Codebeispiel zeigt die Verwendung von ElementAtOrDefault.The following code example demonstrates how to use ElementAtOrDefault. In diesem Beispiel wird ein Index verwendet, der sich außerhalb der Grenzen des Arrays befindet.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.
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]

Hinweise

Wenn der Typ von source IList<T>implementiert, wird diese Implementierung verwendet, um das Element am angegebenen Index abzurufen.If the type of source implements IList<T>, that implementation is used to obtain the element at the specified index. Andernfalls ruft diese Methode das angegebene Element ab.Otherwise, this method obtains the specified element.

Der Standardwert für Verweis-und Werte zulässt-Typen ist null.The default value for reference and nullable types is null.

Gilt für: