Enumerable.First Yöntem

Tanım

Bir dizinin ilk öğesini döndürür.

Aşırı Yüklemeler

First<TSource>(IEnumerable<TSource>)

Bir dizinin ilk öğesini döndürür.

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

Belirtilen koşulu karşılayan bir dizideki ilk öğeyi döndürür.

First<TSource>(IEnumerable<TSource>)

Kaynak:
First.cs
Kaynak:
First.cs
Kaynak:
First.cs

Bir dizinin ilk öğesini döndürür.

C#
public static TSource First<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

Tür Parametreleri

TSource

öğelerinin sourcetürü.

Parametreler

source
IEnumerable<TSource>

öğesinin IEnumerable<T> ilk öğesini döndürmek için.

Döndürülenler

TSource

Belirtilen dizideki ilk öğe.

Özel durumlar

source, null değeridir.

Kaynak dizisi boş.

Örnekler

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

C#
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
*/

Açıklamalar

yöntemi First<TSource>(IEnumerable<TSource>) , öğe içermiyorsa source bir özel durum oluşturur. Bunun yerine, kaynak dizisi boş olduğunda varsayılan bir değer döndürmek FirstOrDefault için yöntemini kullanın.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Kaynak:
First.cs
Kaynak:
First.cs
Kaynak:
First.cs

Belirtilen koşulu karşılayan bir dizideki ilk öğeyi döndürür.

C#
public static TSource First<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

Tür Parametreleri

TSource

öğelerinin sourcetürü.

Parametreler

source
IEnumerable<TSource>

Öğesi IEnumerable<T> döndürülecek öğesi.

predicate
Func<TSource,Boolean>

Bir koşul için her öğeyi test etmek için bir işlev.

Döndürülenler

TSource

Belirtilen koşul işlevinde testi geçen dizideki ilk öğe.

Özel durumlar

source veya predicate şeklindedir null.

hiçbir öğe içindeki predicatekoşulu karşılar.

-veya-

Kaynak dizisi boş.

Örnekler

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

C#
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
*/

Açıklamalar

içinde First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) eşleşen bir öğe bulunamazsa sourceyöntemi bir özel durum oluşturur. Bunun yerine eşleşen öğe bulunamadığında varsayılan bir değer döndürmek FirstOrDefault için yöntemini kullanın.

Şunlara uygulanır

.NET 9 ve diğer sürümler
Ürün Sürümler
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0