Bagikan melalui


Enumerable.First Metode

Definisi

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
Sumber:
First.cs
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

sourceadalah null.

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 .

Berlaku untuk

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

Sumber:
First.cs
Sumber:
First.cs
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

source atau predicate adalah null.

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 .

Berlaku untuk