Enumerable.First Yöntem

Tanım

Sıradaki ilk öğeyi döndürür.Returns the first element of a sequence.

Aşırı Yüklemeler

First<TSource>(IEnumerable<TSource>)

Sıradaki ilk öğeyi döndürür.Returns the first element of a sequence.

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

Belirli bir koşulu karşılayan bir dizideki ilk öğeyi döndürür.Returns the first element in a sequence that satisfies a specified condition.

First<TSource>(IEnumerable<TSource>)

Sıradaki ilk öğeyi döndürür.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

Tür Parametreleri

TSource

Öğelerinin türü source .The type of the elements of source.

Parametreler

source
IEnumerable<TSource>

IEnumerable<T>İlk öğesini döndürmek için.The IEnumerable<T> to return the first element of.

Döndürülenler

TSource

Belirtilen dizideki ilk öğe.The first element in the specified sequence.

Özel durumlar

source, null değeridir.source is null.

Kaynak sırası boş.The source sequence is empty.

Örnekler

Aşağıdaki kod örneği, First<TSource>(IEnumerable<TSource>) bir dizinin ilk öğesini döndürmek için nasıl kullanılacağını gösterir.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

Açıklamalar

First<TSource>(IEnumerable<TSource>)Yöntemi, hiçbir öğe içermiyorsa bir özel durum oluşturur source .The First<TSource>(IEnumerable<TSource>) method throws an exception if source contains no elements. Bunun yerine, kaynak sırası boş olduğunda varsayılan bir değer döndürmek için FirstOrDefault yöntemini kullanın.To instead return a default value when the source sequence is empty, use the FirstOrDefault method.

Şunlara uygulanır

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

Belirli bir koşulu karşılayan bir dizideki ilk öğeyi döndürür.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

Tür Parametreleri

TSource

Öğelerinin türü source .The type of the elements of source.

Parametreler

source
IEnumerable<TSource>

' IEnumerable<T> Dan bir öğe döndürmek için.An IEnumerable<T> to return an element from.

predicate
Func<TSource,Boolean>

Her öğeyi bir koşula göre test etmek için bir işlev.A function to test each element for a condition.

Döndürülenler

TSource

Belirtilen koşul işlevindeki testi geçiren dizideki ilk öğe.The first element in the sequence that passes the test in the specified predicate function.

Özel durumlar

source ya predicate da null .source or predicate is null.

Öğesinde koşulu karşılayan hiçbir öğe yok predicate .No element satisfies the condition in predicate.

-veya--or- Kaynak sırası boş.The source sequence is empty.

Örnekler

Aşağıdaki kod örneği, First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) bir koşulu karşılayan bir dizinin ilk öğesini döndürmek için nasıl kullanılacağını gösterir.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

Açıklamalar

First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)İçinde eşleşen bir öğe bulunamazsa yöntemi bir özel durum oluşturur source .The First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) method throws an exception if no matching element is found in source. Bunun yerine, eşleşen bir öğe bulunamadığında varsayılan bir değer döndürmek için FirstOrDefault yöntemini kullanın.To instead return a default value when no matching element is found, use the FirstOrDefault method.

Şunlara uygulanır