Enumerable.ElementAtOrDefault Metode

Definisi

Ruang nama:

System.Linq

Rakitan:

System.Linq.dll

Overload

ElementAtOrDefault<TSource>(IEnumerable<TSource>, Index)	Mengembalikan elemen pada indeks tertentu secara berurutan atau nilai default jika indeks berada di luar rentang.
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32)	Mengembalikan elemen pada indeks tertentu secara berurutan atau nilai default jika indeks berada di luar rentang.

ElementAtOrDefault<TSource>(IEnumerable<TSource>, Index)

Sumber:

ElementAt.cs

Mengembalikan elemen pada indeks tertentu secara berurutan atau nilai default jika indeks berada di luar rentang.

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

public static TSource? ElementAtOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Index index);

static member ElementAtOrDefault : seq<'Source> * Index -> 'Source

<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IEnumerable(Of TSource), index As Index) As TSource

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

IEnumerable<T> Untuk mengembalikan elemen dari.

index

Index

Indeks elemen yang akan diambil, yaitu dari awal atau akhir urutan.

Mengembalikan

TSource

default jika index berada di luar batas source urutan; jika tidak, elemen pada posisi yang ditentukan dalam source urutan.

Pengecualian

ArgumentNullException

sourceadalah null.

Keterangan

Jika jenis source implementasi IList<T>, implementasi tersebut digunakan untuk mendapatkan elemen pada indeks yang ditentukan. Jika tidak, metode ini mendapatkan elemen yang ditentukan.

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

ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32)

Sumber:

ElementAt.cs

Mengembalikan elemen pada indeks tertentu secara berurutan atau nilai default jika indeks berada di luar rentang.

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

public static TSource? ElementAtOrDefault<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, int index);

static member ElementAtOrDefault : seq<'Source> * int -> 'Source

<Extension()>
Public Function ElementAtOrDefault(Of TSource) (source As IEnumerable(Of TSource), index As Integer) As TSource

Jenis parameter

TSource

Jenis elemen source.

Parameter

source

IEnumerable<TSource>

IEnumerable<T> Untuk mengembalikan elemen dari.

index

Int32

Indeks berbasis nol dari elemen yang akan diambil.

Mengembalikan

TSource

default(TSource) jika indeks berada di luar batas urutan sumber; jika tidak, elemen pada posisi yang ditentukan dalam urutan sumber.

Pengecualian

ArgumentNullException

sourceadalah null.

Contoh

Contoh kode berikut menunjukkan cara menggunakan ElementAtOrDefault. Contoh ini menggunakan indeks yang berada di luar batas array.

string[] names =
    { "Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow",
        "Hedlund, Magnus", "Ito, Shu" };

int index = 20;

string name = names.ElementAtOrDefault(index);

Console.WriteLine(
    "The name chosen at index {0} is '{1}'.",
    index,
    String.IsNullOrEmpty(name) ? "<no name at this index>" : name);

/*
 This code produces the following output:

 The name chosen at index 20 is '<no name at this index>'.
*/

' Create an array of strings.
Dim names() As String =
{"Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow", "Hedlund, Magnus", "Ito, Shu"}

Dim index As Integer = 20

' Get a string at an index that is out of range in the array.
Dim name As String = names.ElementAtOrDefault(index)

Dim text As String = If(String.IsNullOrEmpty(name), "[THERE IS NO NAME AT THIS INDEX]", name)

' Display the output.
Console.WriteLine($"The name chosen at index {index} is {text}")

' This code produces the following output:
'
' The name chosen at index 20 is [THERE IS NO NAME AT THIS INDEX]

Keterangan

Jika jenis source implementasi IList<T>, implementasi tersebut digunakan untuk mendapatkan elemen pada indeks yang ditentukan. Jika tidak, metode ini mendapatkan elemen yang ditentukan.

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