Enumerable.First Metoda

Definicja

Przestrzeń nazw:
System.Linq
Zestaw:
System.Linq.dll
Zestaw:
netstandard.dll
Zestaw:
System.Core.dll

Zwraca pierwszy element sekwencji.Returns the first element of a sequence.

Przeciążenia

First<TSource>(IEnumerable<TSource>)

Zwraca pierwszy element sekwencji.Returns the first element of a sequence.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Zwraca pierwszy element w sekwencji, który spełnia określony warunek.Returns the first element in a sequence that satisfies a specified condition.

First<TSource>(IEnumerable<TSource>)

Zwraca pierwszy element sekwencji.Returns 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

Parametry typu

TSource

Typ elementów source .The type of the elements of source.

Parametry

source
IEnumerable<TSource>

IEnumerable<T>Do zwrócenia pierwszego elementu.The IEnumerable<T> to return the first element of.

Zwraca

TSource

Pierwszy element w określonej sekwencji.The first element in the specified sequence.

Wyjątki

ArgumentNullException

source to null.source is null.

InvalidOperationException

Sekwencja źródłowa jest pusta.The source sequence is empty.

Przykłady

Poniższy przykład kodu demonstruje, jak użyć First<TSource>(IEnumerable<TSource>) do zwrócenia pierwszego elementu tablicy.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

Uwagi

First<TSource>(IEnumerable<TSource>)Metoda zgłasza wyjątek, jeśli source nie zawiera żadnych elementów.The First<TSource>(IEnumerable<TSource>) method throws an exception if source contains no elements. Aby zamiast tego zwrócić wartość domyślną, gdy sekwencja źródłowa jest pusta, użyj FirstOrDefault metody.To instead return a default value when the source sequence is empty, use the FirstOrDefault method.

Dotyczy

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

Zwraca pierwszy element w sekwencji, który spełnia określony warunek.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

Parametry typu

TSource

Typ elementów source .The type of the elements of source.

Parametry

source
IEnumerable<TSource>

IEnumerable<T>Do zwrócenia elementu z.An IEnumerable<T> to return an element from.

predicate
Func<TSource,Boolean>

Funkcja testowania każdego elementu na stanie.A function to test each element for a condition.

Zwraca

TSource

Pierwszy element w sekwencji, który przekazuje test w określonej funkcji predykatu.The first element in the sequence that passes the test in the specified predicate function.

Wyjątki

ArgumentNullException

source lub predicate jest null .source or predicate is null.

InvalidOperationException

Żaden element nie spełnia warunku w elemencie predicate .No element satisfies the condition in predicate.

-lub--or- Sekwencja źródłowa jest pusta.The source sequence is empty.

Przykłady

Poniższy przykład kodu demonstruje, jak użyć First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) do zwrócenia pierwszego elementu tablicy, który spełnia warunek.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

Uwagi

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)Metoda zgłasza wyjątek, jeśli nie znaleziono pasującego elementu w source .The First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an exception if no matching element is found in source. Aby zamiast tego zwrócić wartość domyślną, gdy nie znaleziono pasującego elementu, użyj FirstOrDefault metody.To instead return a default value when no matching element is found, use the FirstOrDefault method.

Dotyczy