Enumerable.First Methode

Definition

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

Gibt das erste Element einer Sequenz zurückReturns the first element of a sequence.

Überlädt

First<TSource>(IEnumerable<TSource>)

Gibt das erste Element einer Sequenz zurückReturns the first element of a sequence.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Gibt das erste Element in einer Sequenz zurück, das eine angegebene Bedingung erfüllt.Returns the first element in a sequence that satisfies a specified condition.

First<TSource>(IEnumerable<TSource>)

Gibt das erste Element einer Sequenz zurückReturns the first element of a sequence.

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.The type of the elements of source.

Parameter

source
IEnumerable<TSource>

Das IEnumerable<T>, dessen erstes Element zurückgegeben werden sollThe IEnumerable<T> to return the first element of.

Gibt zurück

TSource

Das erste Element in der angegebenen Sequenz.The first element in the specified sequence.

Ausnahmen

ArgumentNullException

source ist null.source is null.

InvalidOperationException

Die Quellsequenz ist leer.The source sequence is empty.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie First<TSource>(IEnumerable<TSource>) verwendet wird, um das erste Element eines Arrays zurückzugeben.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>) to return the first element of an array.

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 enthält.The First<TSource>(IEnumerable<TSource>) method throws an exception if source contains no elements. Um stattdessen einen Standardwert zurückzugeben, wenn die Quell Sequenz leer ist, verwenden Sie die FirstOrDefault-Methode.To instead return a default value when the source sequence is empty, use the FirstOrDefault method.

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

Gibt das erste Element in einer Sequenz zurück, das eine angegebene Bedingung erfüllt.Returns the first element in a sequence that satisfies a specified condition.

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

predicate
Func<TSource,Boolean>

Eine Funktion, mit der jedes Element auf eine Bedingung überprüft wird.A function to test each element for a condition.

Gibt zurück

TSource

Das erste Element in der Sequenz, das mit der angegebenen Prädikatfunktion erfolgreich überprüft wird.The first element in the sequence that passes the test in the specified predicate function.

Ausnahmen

ArgumentNullException

source oder predicate ist null.source or predicate is null.

InvalidOperationException

Kein Element erfüllt die Bedingung in predicate.No element satisfies the condition in predicate.

- oder --or- Die Quellsequenz ist leer.The source sequence is empty.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) verwendet wird, um das erste Element eines Arrays zurückzugeben, das eine Bedingung erfüllt.The following code example demonstrates how to use First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) to return the first element of an array that satisfies a condition.

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 entsprechendes Element in sourcegefunden wird.The First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an exception if no matching element is found in source. Um stattdessen einen Standardwert zurückzugeben, wenn kein entsprechendes Element gefunden wird, verwenden Sie die FirstOrDefault-Methode.To instead return a default value when no matching element is found, use the FirstOrDefault method.

Gilt für: