Enumerable.First Metoda

Definicja

Przestrzeń nazw:

System.Linq

Zestaw:

System.Linq.dll

Zwraca pierwszy element sekwencji.

Przeciążenia

First<TSource>(IEnumerable<TSource>)	Zwraca pierwszy element sekwencji.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Zwraca pierwszy element w sekwencji, który spełnia określony warunek.

First<TSource>(IEnumerable<TSource>)

Źródło:

First.cs

Zwraca pierwszy element sekwencji.

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

Parametry

source

IEnumerable<TSource>

Element IEnumerable<T> , aby zwrócić pierwszy element.

Zwraca

TSource

Pierwszy element w określonej sekwencji.

Wyjątki

ArgumentNullException

source to null.

InvalidOperationException

Sekwencja źródłowa jest pusta.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć First<TSource>(IEnumerable<TSource>) polecenia , aby zwrócić pierwszy element tablicy.

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

Metoda First<TSource>(IEnumerable<TSource>) zgłasza wyjątek, jeśli source nie zawiera żadnych elementów. Aby zamiast tego zwrócić wartość domyślną, gdy sekwencja źródłowa jest pusta, użyj FirstOrDefault metody .

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

Źródło:

First.cs

Zwraca pierwszy element w sekwencji, który spełnia określony warunek.

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

Parametry

source

IEnumerable<TSource>

Element do IEnumerable<T> zwrócenia elementu z.

predicate

Func<TSource,Boolean>

Funkcja testowania każdego elementu na stanie.

Zwraca

TSource

Pierwszy element w sekwencji, który przechodzi test w określonej funkcji predykatu.

Wyjątki

ArgumentNullException

source lub predicate to null.

InvalidOperationException

Żaden element nie spełnia warunku w elemecie predicate.

-lub-

Sekwencja źródłowa jest pusta.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) polecenia , aby zwrócić pierwszy element tablicy, który spełnia warunek.

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

Metoda First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) zgłasza wyjątek, jeśli w elemecie nie znaleziono sourcepasującego elementu . Aby zamiast tego zwrócić wartość domyślną, gdy nie znaleziono pasującego elementu, użyj FirstOrDefault metody .