Enumerable.First Methode

Definition

Namespace:
System.Linq
Assemblys:
System.Core.dll, System.Linq.dll
Assembly:
System.Core.dll
Assembly:
System.Linq.dll
Assembly:
netstandard.dll

Gibt das erste Element einer Sequenz zurück.

Überlädt

Name Beschreibung
First<TSource>(IEnumerable<TSource>)

Gibt das erste Element einer Sequenz zurück.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Gibt das erste Element in einer Sequenz zurück, das eine angegebene Bedingung erfüllt.

First<TSource>(IEnumerable<TSource>)

Gibt das erste Element einer Sequenz zurück.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Collections::Generic::IEnumerable<TSource> ^ source);
public static TSource First<TSource>(this System.Collections.Generic.IEnumerable<TSource> source);
static member First : seq<'Source> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IEnumerable(Of TSource)) As TSource

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IEnumerable<TSource>

Gibt IEnumerable<T> das erste Element zurück.

Gibt zurück

TSource

Das erste Element in der angegebenen Sequenz.

Ausnahmen

ArgumentNullException

source ist null.

InvalidOperationException

Die Quellsequenz ist leer.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie First<TSource>(IEnumerable<TSource>) das erste Element eines Arrays zurückgegeben wird.

int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54,
                    83, 23, 87, 435, 67, 12, 19 };

int first = numbers.First();

Console.WriteLine(first);

/*
 This code produces the following output:

 9
*/

' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array.
Dim first As Integer = numbers.First()

' Display the output.
Console.WriteLine(first)

' This code produces the following output:
'
' 9

Hinweise

Die First<TSource>(IEnumerable<TSource>) Methode löst eine Ausnahme aus, wenn source keine Elemente enthalten sind. Verwenden Sie die FirstOrDefault Methode, um stattdessen einen Standardwert zurückzugeben, wenn die Quellsequenz leer ist.

Gilt für:

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Gibt das erste Element in einer Sequenz zurück, das eine angegebene Bedingung erfüllt.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource First(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);
public static TSource First<TSource>(this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);
static member First : seq<'Source> * Func<'Source, bool> -> 'Source
<Extension()>
Public Function First(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean)) As TSource

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T> , von dem ein Element zurückgegeben werden soll.

predicate
Func<TSource,Boolean>

Eine Funktion zum Testen der einzelnen Elemente für eine Bedingung.

Gibt zurück

TSource

Das erste Element in der Sequenz, das den Test in der angegebenen Prädikatfunktion bestanden hat.

Ausnahmen

ArgumentNullException

source oder predicate ist null.

InvalidOperationException

Kein Element erfüllt die Bedingung in predicate.

-oder-

Die Quellsequenz ist leer.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) das erste Element eines Arrays zurückgegeben wird, das eine Bedingung erfüllt.

int[] numbers = { 9, 34, 65, 92, 87, 435, 3, 54,
                    83, 23, 87, 435, 67, 12, 19 };

int first = numbers.First(number => number > 80);

Console.WriteLine(first);

/*
 This code produces the following output:

 92
*/

' Create an array of integers.
Dim numbers() As Integer =
{9, 34, 65, 92, 87, 435, 3, 54, 83, 23, 87, 435, 67, 12, 19}

' Select the first element in the array whose value is greater than 80.
Dim first As Integer = numbers.First(Function(number) number > 80)

' Display the output.
Console.WriteLine(first)

' This code produces the following output:
'
' 92

Hinweise

Die First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) Methode löst eine Ausnahme aus, wenn kein übereinstimmende Element gefunden sourcewird. Verwenden Sie die FirstOrDefault Methode, um stattdessen einen Standardwert zurückzugeben, wenn kein übereinstimmende Element gefunden wird.

Gilt für: