Enumerable.First Yöntem

Tanım

Ad Alanı:

System.Linq

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Linq.dll

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

Aşırı Yüklemeler

Name	Description
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

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

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 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

ArgumentNullException

source, null'e eşittir.

InvalidOperationException

Kaynak sıra 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.

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

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.

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

Kaynak:

First.cs

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

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 sourcetürü.

Parametreler

source

IEnumerable<TSource>

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

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çiren dizideki ilk öğe.

Özel durumlar

ArgumentNullException

source veya predicate şeklindedir null.

InvalidOperationException

içindeki koşulu predicatekarşılayan öğe yok.

-veya-

Kaynak sıra 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.

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

içinde First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) eşleşen öğe bulunmazsa 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.