Enumerable.First Metode

Definisi

Ruang nama:

System.Linq

Rakitan:

System.Linq.dll

Mengembalikan elemen pertama dari urutan.

Overload

First<TSource>(IEnumerable<TSource>)	Mengembalikan elemen pertama dari urutan.
First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Mengembalikan elemen pertama dalam urutan yang memenuhi kondisi tertentu.

First<TSource>(IEnumerable<TSource>)

Sumber:

First.cs

Mengembalikan elemen pertama dari urutan.

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

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

IEnumerable<T> untuk mengembalikan elemen pertama.

Mengembalikan

TSource

Elemen pertama dalam urutan yang ditentukan.

Pengecualian

ArgumentNullException

sourceadalah null.

InvalidOperationException

Urutan sumber kosong.

Contoh

Contoh kode berikut menunjukkan cara menggunakan First<TSource>(IEnumerable<TSource>) untuk mengembalikan elemen pertama dari 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

Keterangan

Metode ini First<TSource>(IEnumerable<TSource>) memberikan pengecualian jika source tidak berisi elemen. Untuk mengembalikan nilai default saat urutan sumber kosong, gunakan FirstOrDefault metode .

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

Sumber:

First.cs

Mengembalikan elemen pertama dalam urutan yang memenuhi kondisi tertentu.

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

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

Untuk IEnumerable<T> mengembalikan elemen dari.

predicate

Func<TSource,Boolean>

Fungsi untuk menguji setiap elemen untuk suatu kondisi.

Mengembalikan

TSource

Elemen pertama dalam urutan yang lulus pengujian dalam fungsi predikat yang ditentukan.

Pengecualian

ArgumentNullException

source atau predicate adalah null.

InvalidOperationException

Tidak ada elemen yang memenuhi kondisi dalam predicate.

-atau-

Urutan sumber kosong.

Contoh

Contoh kode berikut menunjukkan cara menggunakan First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) untuk mengembalikan elemen pertama dari array yang memenuhi kondisi.

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

Keterangan

Metode First<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) ini memberikan pengecualian jika tidak ada elemen yang cocok yang ditemukan di source. Untuk mengembalikan nilai default ketika tidak ada elemen yang cocok yang ditemukan, gunakan FirstOrDefault metode .