Enumerable.First Metoda

Definice

Vrátí první prvek sekvence.Returns the first element of a sequence.

Přetížení

First<TSource>(IEnumerable<TSource>)

Vrátí první prvek sekvence.Returns the first element of a sequence.

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

Vrátí první prvek v sekvenci, která splňuje zadanou podmínku.Returns the first element in a sequence that satisfies a specified condition.

First<TSource>(IEnumerable<TSource>)

Vrátí první prvek sekvence.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 prvků source .The type of the elements of source.

Parametry

source
IEnumerable<TSource>

IEnumerable<T>Pro vrácení prvního prvku.The IEnumerable<T> to return the first element of.

Návraty

TSource

První prvek v zadané sekvenci.The first element in the specified sequence.

Výjimky

source je null.source is null.

Zdrojová sekvence je prázdná.The source sequence is empty.

Příklady

Následující příklad kódu ukazuje, jak použít First<TSource>(IEnumerable<TSource>) k vrácení prvního prvku pole.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

Poznámky

First<TSource>(IEnumerable<TSource>)Metoda vyvolá výjimku source , pokud neobsahuje žádné elementy.The First<TSource>(IEnumerable<TSource>) method throws an exception if source contains no elements. Chcete-li místo toho vrátit výchozí hodnotu, pokud je zdrojová sekvence prázdná, použijte FirstOrDefault metodu.To instead return a default value when the source sequence is empty, use the FirstOrDefault method.

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

Vrátí první prvek v sekvenci, která splňuje zadanou podmínku.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 prvků source .The type of the elements of source.

Parametry

source
IEnumerable<TSource>

IEnumerable<T>A vrátí prvek z.An IEnumerable<T> to return an element from.

predicate
Func<TSource,Boolean>

Funkce pro otestování každého prvku podmínky.A function to test each element for a condition.

Návraty

TSource

První prvek v sekvenci, který projde testem v zadané funkci predikátu.The first element in the sequence that passes the test in the specified predicate function.

Výjimky

source nebo predicate je null .source or predicate is null.

Žádný element nesplňuje podmínky v predicate .No element satisfies the condition in predicate.

-nebo--or- Zdrojová sekvence je prázdná.The source sequence is empty.

Příklady

Následující příklad kódu ukazuje, jak použít First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) k vrácení prvního prvku pole, které splňuje podmínku.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

Poznámky

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)Metoda vyvolá výjimku, pokud není nalezen žádný vyhovující element v source .The First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an exception if no matching element is found in source. Chcete-li místo toho vrátit výchozí hodnotu, pokud není nalezen žádný vyhovující element, použijte FirstOrDefault metodu.To instead return a default value when no matching element is found, use the FirstOrDefault method.

Platí pro