Enumerable.ElementAt Yöntem

Tanım

Ad Alanı:

System.Linq

Bütünleştirilmiş Kod:

System.Linq.dll

Bütünleştirilmiş Kod:

System.Core.dll

Bütünleştirilmiş Kod:

netstandard.dll

Aşırı Yüklemeler

ElementAt<TSource>(IEnumerable<TSource>, Index)	Bir dizideki belirtilen dizindeki öğesini döndürür.
ElementAt<TSource>(IEnumerable<TSource>, Int32)	Bir dizideki belirtilen dizindeki öğesini döndürür.

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

Bir dizideki belirtilen dizindeki öğesini döndürür.

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

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

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

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

Tür Parametreleri

TSource

öğelerinin sourcetü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

Dizide belirtilen konumdaki source öğesi.

Özel durumlar

ArgumentNullException

source, null değeridir.

ArgumentOutOfRangeException

index dizinin sınırlarının source dışındadır.

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.

Bu yöntem, aralık dışındaysa index bir özel durum oluşturur. Bunun yerine, belirtilen dizin aralık dışında olduğunda varsayılan bir değer döndürmek ElementAtOrDefault için yöntemini kullanın.

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

Bir dizideki belirtilen dizindeki öğesini döndürür.

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

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

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

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

Tür Parametreleri

TSource

öğelerinin sourcetü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

Kaynak dizisinde belirtilen konumdaki öğesi.

Özel durumlar

ArgumentNullException

source, null değeridir.

ArgumentOutOfRangeException

index 0'dan küçük veya içindeki sourceöğe sayısından büyük veya buna eşit.

Örnekler

Aşağıdaki kod örneği, belirli bir konumdaki bir öğeyi döndürmek için nasıl kullanılacağını ElementAt gösterir.

string[] names =
    { "Hartono, Tommy", "Adams, Terry", "Andersen, Henriette Thaulow",

        "Hedlund, Magnus", "Ito, Shu" };
Random random = new Random(DateTime.Now.Millisecond);

string name = names.ElementAt(random.Next(0, names.Length));

Console.WriteLine("The name chosen at random is '{0}'.", name);

/*
 This code produces output similar to the following:

 The name chosen at random is 'Ito, Shu'.
*/

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

Dim random As Random = New Random(DateTime.Now.Millisecond)

' Get a string at a random index within the array.
Dim name As String = names.ElementAt(random.Next(0, names.Length))

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

' This code produces output similar to the following:
'
' The name chosen at random is Ito, Shu

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.

Bu yöntem, aralık dışındaysa index bir özel durum oluşturur. Bunun yerine, belirtilen dizin aralık dışında olduğunda varsayılan bir değer döndürmek ElementAtOrDefault için yöntemini kullanın.