Enumerable.ElementAtOrDefault Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
Aşırı Yüklemeler
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Index) |
Dizin aralık dışındaysa, belirtilen dizindeki bir dizideki veya varsayılan değerdeki öğesini döndürür. |
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32) |
Dizin aralık dışındaysa, belirtilen dizindeki bir dizideki veya varsayılan değerdeki öğesini döndürür. |
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Index)
Dizin aralık dışındaysa, belirtilen dizindeki bir dizideki veya varsayılan değerdeki öğesini döndürür.
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
Tür Parametreleri
- TSource
öğelerinin source
türü.
Parametreler
- source
- IEnumerable<TSource>
Öğesi IEnumerable<T> döndürülecek öğesi.
- index
- Index
Dizinin başından veya sonundan gelen, alınacak öğenin dizini.
Döndürülenler
- TSource
default
dizi sınırlarının source
dışındaysaindex
; aksi takdirde, öğe dizide source
belirtilen konumdadır.
Özel durumlar
source
, null
değeridir.
Açıklamalar
türü source
uygularsa IList<T>, belirtilen dizindeki öğesini almak için bu uygulama kullanılır. Aksi takdirde, bu yöntem belirtilen öğeyi alır.
Başvuru ve null atanabilir türler için varsayılan değerdir null
.
Şunlara uygulanır
ElementAtOrDefault<TSource>(IEnumerable<TSource>, Int32)
Dizin aralık dışındaysa, belirtilen dizindeki bir dizideki veya varsayılan değerdeki öğesini döndürür.
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);
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
Tür Parametreleri
- TSource
öğelerinin source
türü.
Parametreler
- source
- IEnumerable<TSource>
Öğesi IEnumerable<T> döndürülecek öğesi.
- index
- Int32
Alınacak öğenin sıfır tabanlı dizini.
Döndürülenler
- TSource
default
(TSource
) dizin kaynak dizisinin sınırlarının dışındaysa; aksi takdirde, kaynak dizide belirtilen konumdaki öğe.
Özel durumlar
source
, null
değeridir.
Örnekler
Aşağıdaki kod örneğinde nasıl kullanılacağı ElementAtOrDefaultgösterilmektedir. Bu örnek, dizinin sınırlarının dışında bir dizin kullanır.
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]
Açıklamalar
türü source
uygularsa IList<T>, belirtilen dizindeki öğesini almak için bu uygulama kullanılır. Aksi takdirde, bu yöntem belirtilen öğeyi alır.
Başvuru ve null atanabilir türler için varsayılan değerdir null
.