Enumerable.First Methode

  • Referenz

Definition

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

Gibt das erste Element einer Sequenz zurück

Überlädt

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>)

Quelle:
First.cs
Quelle:
First.cs
Quelle:
First.cs

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>

Das IEnumerable<T>, dessen erstes Element zurückgegeben werden soll

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 -Methode, um stattdessen einen Standardwert zurückzugeben, wenn die FirstOrDefault Quellsequenz leer ist.

Gilt für:

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

Quelle:
First.cs
Quelle:
First.cs
Quelle:
First.cs

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>, aus dem ein Element zurückgegeben werden soll

predicate
Func<TSource,Boolean>

Eine Funktion, mit der jedes Element auf eine Bedingung überprüft wird.

Gibt zurück

TSource

Das erste Element in der Sequenz, das mit der angegebenen Prädikatfunktion erfolgreich überprüft wird.

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 in sourcegefunden wird. Verwenden Sie die FirstOrDefault -Methode, um stattdessen einen Standardwert zurückzugeben, wenn kein übereinstimmende Element gefunden wird.

Gilt für: