Информация
Запрошенная вами тема показана ниже. Однако эта тема не включена в библиотеку.

Enumerable.ElementAtOrDefault<TSource> - метод

Возвращает элемент по указанному индексу в последовательности или значение по умолчанию, если индекс вне допустимого диапазона.

Пространство имен:  System.Linq
Сборка:  System.Core (в System.Core.dll)

public static TSource ElementAtOrDefault<TSource>(
	this IEnumerable<TSource> source,
	int index
)

Параметры типа

TSource

Тип элементов последовательности source.

Параметры

source
Тип: System.Collections.Generic.IEnumerable<TSource>
Объект IEnumerable<T>, из которого требуется возвратить элемент.
index
Тип: System.Int32
Отсчитываемый от нуля индекс извлекаемого элемента.

Возвращаемое значение

Тип: TSource
default (TSource), если индекс указывает позицию вне исходной последовательности, в противном случае — элемент, находящийся в указанной позиции в исходной последовательности.

Примечание об использовании

В Visual Basic и C# этот метод можно вызывать как метод экземпляра для любого объекта типа IEnumerable<TSource>. При вызове метода для экземпляра следует опускать первый параметр. Дополнительные сведения см. в разделе Методы расширения (Visual Basic) или Методы расширения (Руководство по программированию в C#).

ИсключениеУсловие
ArgumentNullException

Параметр source имеет значение null.

Если тип последовательности source реализует интерфейс IList<T>, эта реализация и используется для получения элемента по заданному индексу. В противном случае указанный элемент извлекается с помощью данного метода.

Для ссылочных и обнуляемых типов значением по умолчанию является null.

В следующем примере кода демонстрируется использование метода ElementAtOrDefault<TSource>. В примере используется индекс, определяющий позицию вне массива.


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



.NET Framework

Поддерживается в версиях: 4.5.2, 4.5.1, 4.5, 4, 3.5

.NET Framework (клиентский профиль)

Поддерживается в версиях: 4, 3.5 с пакетом обновления 1 (SP1)

Переносимая библиотека классов

Поддерживается в версии: Переносимая библиотека классов

Приложения .NET для Магазина Windows

Поддерживается в версии: Windows 8

Приложения .NET для Windows Phone

Поддерживается в версиях: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista с пакетом обновления 2 (SP2), Windows Server 2008 (роль основных серверных компонентов не поддерживается), Windows Server 2008 R2 (роль основных серверных компонентов поддерживается в пакете обновления 1 (SP1) или выше; системы на базе Itanium не поддерживаются)

.NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.

Добавления сообщества

Показ:
© 2014 Microsoft