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

Enumerable.Where<TSource> - метод (IEnumerable<TSource>, Func<TSource, Boolean>)

Выполняет фильтрацию последовательности значений на основе заданного предиката.

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

public static IEnumerable<TSource> Where<TSource>(
	this IEnumerable<TSource> source,
	Func<TSource, bool> predicate
)

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

TSource

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

Параметры

source
Тип: System.Collections.Generic.IEnumerable<TSource>
Объект IEnumerable<T>, подлежащий фильтрации.
predicate
Тип: System.Func<TSource, Boolean>
Функция для проверки каждого элемента на соответствие условию.

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

Тип: System.Collections.Generic.IEnumerable<TSource>
Объект IEnumerable<T>, содержащий элементы входной последовательности, которые удовлетворяют условию.

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

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

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

Значение параметра source или predicatenull.

Данный метод реализуется с использованием отложенного выполнения. Немедленно возвращаемое значение — это объект, в котором хранится вся информация, необходимая для выполнения операции. Запрос, представленный данным методом, не выполняется до тех пор, пока не будет произведено перечисление объекта путем непосредственного вызова его метода GetEnumerator или с помощью оператора foreach в Visual C# либо For Each в Visual Basic.

В синтаксисе выражения запроса предложение where (Visual C#) или Where (Visual Basic) транслируется в вызов Where<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>).

В следующем примере кода демонстрируется использование метода Where<TSource>(IEnumerable<TSource>, Func<TSource, Boolean>) для фильтрации последовательности.


            List<string> fruits =
                new List<string> { "apple", "passionfruit", "banana", "mango", 
                                "orange", "blueberry", "grape", "strawberry" };

            IEnumerable<string> query = fruits.Where(fruit => fruit.Length < 6);

            foreach (string fruit in query)
            {
                Console.WriteLine(fruit);
            }
            /*
             This code produces the following output:

             apple
             mango
             grape
            */



.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