Enumerable.LastOrDefault Metode

Definisi

Ruang nama:

System.Linq

Rakitan:

System.Linq.dll

Mengembalikan elemen terakhir dari urutan, atau nilai default jika tidak ada elemen yang ditemukan.

Overload

LastOrDefault<TSource>(IEnumerable<TSource>)	Mengembalikan elemen terakhir dari urutan, atau nilai default jika urutan tidak berisi elemen.
LastOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Mengembalikan elemen terakhir dari urutan yang memenuhi kondisi atau nilai default jika tidak ada elemen tersebut yang ditemukan.
LastOrDefault<TSource>(IEnumerable<TSource>, TSource)	Mengembalikan elemen terakhir dari urutan, atau nilai default yang ditentukan jika urutan tidak berisi elemen.
LastOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>, TSource)	Mengembalikan elemen terakhir dari urutan yang memenuhi kondisi, atau nilai default yang ditentukan jika tidak ada elemen tersebut yang ditemukan.

LastOrDefault<TSource>(IEnumerable<TSource>)

Sumber:

Last.cs

Mengembalikan elemen terakhir dari urutan, atau nilai default jika urutan tidak berisi elemen.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource LastOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source);

public static TSource? LastOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

static member LastOrDefault : seq<'Source> -> 'Source

<Extension()>
Public Function LastOrDefault(Of TSource) (source As IEnumerable(Of TSource)) As TSource

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

IEnumerable<T> untuk mengembalikan elemen terakhir.

Mengembalikan

TSource

default(TSource) jika urutan sumber kosong; jika tidak, elemen terakhir dalam IEnumerable<T>.

Pengecualian

ArgumentNullException

source null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan LastOrDefault<TSource>(IEnumerable<TSource>) pada array kosong.

string[] fruits = { };
string last = fruits.LastOrDefault();
Console.WriteLine(
    String.IsNullOrEmpty(last) ? "<string is null or empty>" : last);

/*
 This code produces the following output:

 <string is null or empty>
*/

' Create an empty array.
Dim fruits() As String = {}

' Get the last item in the array, or a
' default value if there are no items.
Dim last As String = fruits.LastOrDefault()

' Display the result.
Console.WriteLine(IIf(String.IsNullOrEmpty(last),
       "<string is Nothing or empty>",
       last))

' This code produces the following output:
'
' <string is Nothing or empty>

Terkadang nilai default(TSource) bukan nilai default yang ingin Anda gunakan jika koleksi tidak berisi elemen. Alih-alih memeriksa hasil untuk nilai default yang tidak diinginkan lalu mengubahnya jika perlu, Anda dapat menggunakan metode DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) untuk menentukan nilai default yang ingin Anda gunakan jika koleksi kosong. Kemudian, panggil Last<TSource>(IEnumerable<TSource>) untuk mendapatkan elemen terakhir. Contoh kode berikut menggunakan kedua teknik untuk mendapatkan nilai default 1 jika kumpulan hari numerik dalam sebulan kosong. Karena nilai default untuk bilangan bulat adalah 0, yang tidak sesuai dengan hari mana pun dalam sebulan, nilai default harus ditentukan sebagai 1 sebagai gantinya. Variabel hasil pertama diperiksa untuk nilai default yang tidak diinginkan setelah kueri selesai dieksekusi. Variabel hasil kedua diperoleh dengan menggunakan DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) untuk menentukan nilai default 1.

List<int> daysOfMonth = new List<int> { };

// Setting the default value to 1 after the query.
int lastDay1 = daysOfMonth.LastOrDefault();
if (lastDay1 == 0)
{
    lastDay1 = 1;
}
Console.WriteLine("The value of the lastDay1 variable is {0}", lastDay1);

// Setting the default value to 1 by using DefaultIfEmpty() in the query.
int lastDay2 = daysOfMonth.DefaultIfEmpty(1).Last();
Console.WriteLine("The value of the lastDay2 variable is {0}", lastDay2);

/*
 This code produces the following output:

 The value of the lastDay1 variable is 1
 The value of the lastDay2 variable is 1
*/

Dim daysOfMonth As New List(Of Integer)(New Integer() {})

' Setting the default value to 1 after the query.
Dim lastDay1 As Integer = daysOfMonth.LastOrDefault()
If lastDay1 = 0 Then
    lastDay1 = 1
End If
Console.WriteLine($"The value of the lastDay1 variable is {lastDay1}")

' Setting the default value to 1 by using DefaultIfEmpty() in the query.
Dim lastDay2 As Integer = daysOfMonth.DefaultIfEmpty(1).Last()
Console.WriteLine($"The value of the lastDay2 variable is {lastDay2}")

' This code produces the following output:
'
' The value of the lastDay1 variable is 1
' The value of the lastDay2 variable is 1

Keterangan

Nilai default untuk jenis referensi dan dapat diubah ke null adalah null.

Metode LastOrDefault tidak menyediakan cara untuk menentukan nilai default. Jika Anda ingin menentukan nilai default selain default(TSource), gunakan metode DefaultIfEmpty<TSource>(IEnumerable<TSource>, TSource) seperti yang dijelaskan di bagian Contoh.

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

Sumber:

Last.cs

Mengembalikan elemen terakhir dari urutan yang memenuhi kondisi atau nilai default jika tidak ada elemen tersebut yang ditemukan.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource LastOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate);

public static TSource? LastOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

static member LastOrDefault : seq<'Source> * Func<'Source, bool> -> 'Source

<Extension()>
Public Function LastOrDefault(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>

IEnumerable<T> untuk mengembalikan elemen.

predicate

Func<TSource,Boolean>

Fungsi untuk menguji setiap elemen untuk kondisi.

Mengembalikan

TSource

default(TSource) jika urutannya kosong atau jika tidak ada elemen yang lulus pengujian dalam fungsi predikat; jika tidak, elemen terakhir yang lulus pengujian dalam fungsi predikat.

Pengecualian

ArgumentNullException

source atau predicatenull.

Contoh

Contoh kode berikut menunjukkan cara menggunakan LastOrDefault<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) dengan meneruskan predikat. Dalam panggilan kedua ke metode , tidak ada elemen dalam urutan yang memenuhi kondisi.

double[] numbers = { 49.6, 52.3, 51.0, 49.4, 50.2, 48.3 };

double last50 = numbers.LastOrDefault(n => Math.Round(n) == 50.0);

Console.WriteLine("The last number that rounds to 50 is {0}.", last50);

double last40 = numbers.LastOrDefault(n => Math.Round(n) == 40.0);

Console.WriteLine(
    "The last number that rounds to 40 is {0}.",
    last40 == 0.0 ? "<DOES NOT EXIST>" : last40.ToString());

/*
 This code produces the following output:

 The last number that rounds to 50 is 50.2.
 The last number that rounds to 40 is <DOES NOT EXIST>.
*/

' Create an array of doubles.
Dim numbers() As Double = {49.6, 52.3, 51.0, 49.4, 50.2, 48.3}

' Get the last item whose value rounds to 50.0.
Dim number50 As Double =
numbers.LastOrDefault(Function(n) Math.Round(n) = 50.0)

Dim output As New System.Text.StringBuilder
output.AppendLine("The last number that rounds to 50 is " & number50)

' Get the last item whose value rounds to 40.0.
Dim number40 As Double =
numbers.LastOrDefault(Function(n) Math.Round(n) = 40.0)

Dim text As String = IIf(number40 = 0.0,
                     "[DOES NOT EXIST]",
                     number40.ToString())
output.AppendLine("The last number that rounds to 40 is " & text)

' Display the output.
Console.WriteLine(output.ToString)

' This code produces the following output:
'
' The last number that rounds to 50 is 50.2
' The last number that rounds to 40 is [DOES NOT EXIST]

Keterangan

Nilai default untuk jenis referensi dan dapat diubah ke null adalah null.

LastOrDefault<TSource>(IEnumerable<TSource>, TSource)

Sumber:

Last.cs

Mengembalikan elemen terakhir dari urutan, atau nilai default yang ditentukan jika urutan tidak berisi elemen.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource LastOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, TSource defaultValue);

public static TSource LastOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, TSource defaultValue);

static member LastOrDefault : seq<'Source> * 'Source -> 'Source

<Extension()>
Public Function LastOrDefault(Of TSource) (source As IEnumerable(Of TSource), defaultValue As TSource) As TSource

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

IEnumerable<T> untuk mengembalikan elemen terakhir.

defaultValue

TSource

Nilai default yang akan dikembalikan jika urutannya kosong.

Mengembalikan

TSource

defaultValue jika urutan sumber kosong; jika tidak, elemen terakhir dalam IEnumerable<T>.

Pengecualian

ArgumentNullException

source null.

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

Sumber:

Last.cs

Mengembalikan elemen terakhir dari urutan yang memenuhi kondisi, atau nilai default yang ditentukan jika tidak ada elemen tersebut yang ditemukan.

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static TSource LastOrDefault(System::Collections::Generic::IEnumerable<TSource> ^ source, Func<TSource, bool> ^ predicate, TSource defaultValue);

public static TSource LastOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate, TSource defaultValue);

static member LastOrDefault : seq<'Source> * Func<'Source, bool> * 'Source -> 'Source

<Extension()>
Public Function LastOrDefault(Of TSource) (source As IEnumerable(Of TSource), predicate As Func(Of TSource, Boolean), defaultValue As TSource) As TSource

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

IEnumerable<T> untuk mengembalikan elemen.

predicate

Func<TSource,Boolean>

Fungsi untuk menguji setiap elemen untuk kondisi.

defaultValue

TSource

Nilai default yang akan dikembalikan jika urutannya kosong.

Mengembalikan

TSource

defaultValue jika urutan kosong atau jika tidak ada elemen yang lulus pengujian dalam fungsi predikat; jika tidak, elemen terakhir yang lulus pengujian dalam fungsi predikat.

Pengecualian

ArgumentNullException

source atau predicatenull.