Enumerable.ElementAt Metoda

Definicja

Przestrzeń nazw:

System.Linq

Zestaw:

System.Linq.dll

Przeciążenia

ElementAt<TSource>(IEnumerable<TSource>, Index)	Zwraca element w określonym indeksie w sekwencji.
ElementAt<TSource>(IEnumerable<TSource>, Int32)	Zwraca element w określonym indeksie w sekwencji.

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

Źródło:

ElementAt.cs

Zwraca element w określonym indeksie w sekwencji.

C#

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

Parametry typu

TSource

Typ elementów elementu source.

Parametry

source

IEnumerable<TSource>

Element IEnumerable<T> do zwrócenia elementu z.

index

Index

Indeks elementu do pobrania, który jest od początku lub na końcu sekwencji.

Zwraca

TSource

Element w określonej pozycji w source sekwencji.

Wyjątki

ArgumentNullException

source to null.

ArgumentOutOfRangeException

index znajduje się poza granicami source sekwencji.

Uwagi

Jeśli typ source implementuje IList<T>, ta implementacja jest używana do uzyskania elementu w określonym indeksie. W przeciwnym razie ta metoda uzyskuje określony element.

Ta metoda zgłasza wyjątek, jeśli index jest poza zakresem. Aby zamiast tego zwrócić wartość domyślną, gdy określony indeks jest poza zakresem, użyj ElementAtOrDefault metody .

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

Źródło:

ElementAt.cs

Zwraca element w określonym indeksie w sekwencji.

C#

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

Parametry typu

TSource

Typ elementów elementu source.

Parametry

source

IEnumerable<TSource>

Element IEnumerable<T> do zwrócenia elementu z.

index

Int32

Indeks zerowy elementu do pobrania.

Zwraca

TSource

Element w określonej pozycji w sekwencji źródłowej.

Wyjątki

ArgumentNullException

source to null.

ArgumentOutOfRangeException

index wartość jest mniejsza niż 0 lub większa lub równa liczbie elementów w elemecie source.

Przykłady

W poniższym przykładzie kodu pokazano, jak użyć polecenia ElementAt , aby zwrócić element w określonej pozycji.

C#

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'.
*/

Uwagi

Jeśli typ source implementuje IList<T>, ta implementacja jest używana do uzyskania elementu w określonym indeksie. W przeciwnym razie ta metoda uzyskuje określony element.

Ta metoda zgłasza wyjątek, jeśli index jest poza zakresem. Aby zamiast tego zwrócić wartość domyślną, gdy określony indeks jest poza zakresem, użyj ElementAtOrDefault metody .