Enumerable.Any Метод

Определение

Пространство имен:

System.Linq

Сборка:

System.Linq.dll

Проверяет существование хотя бы одного элемента в последовательности.

Перегрузки

Any<TSource>(IEnumerable<TSource>)	Проверяет, содержит ли последовательность какие-либо элементы.
Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)	Проверяет, удовлетворяет ли какой-либо элемент последовательности заданному условию.

Any<TSource>(IEnumerable<TSource>)

Исходный код:

AnyAll.cs

Проверяет, содержит ли последовательность какие-либо элементы.

C#

public static bool Any<TSource> (this System.Collections.Generic.IEnumerable<TSource> source);

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

TSource

Тип элементов source.

Параметры

source

IEnumerable<TSource>

Объект IEnumerable<T>, проверяемый на наличие элементов.

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

Boolean

true, если исходная последовательность содержит какие-либо элементы, в противном случае — false.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как с помощью Any определить, содержит ли последовательность какие-либо элементы.

C#

List<int> numbers = new List<int> { 1, 2 };
bool hasElements = numbers.Any();

Console.WriteLine("The list {0} empty.",
    hasElements ? "is not" : "is");

// This code produces the following output:
//
// The list is not empty.

Логическое значение, возвращаемое методом Any<TSource>(IEnumerable<TSource>) , обычно используется в предикате where предложения (Where в Visual Basic) или при прямом вызове Where<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) метода . В следующем примере демонстрируется такое использование Any метода .

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
}
class Person
{
    public string LastName { get; set; }
    public Pet[] Pets { get; set; }
}

public static void AnyEx2()
{
    List<Person> people = new List<Person>
        { new Person { LastName = "Haas",
                       Pets = new Pet[] { new Pet { Name="Barley", Age=10 },
                                          new Pet { Name="Boots", Age=14 },
                                          new Pet { Name="Whiskers", Age=6 }}},
          new Person { LastName = "Fakhouri",
                       Pets = new Pet[] { new Pet { Name = "Snowball", Age = 1}}},
          new Person { LastName = "Antebi",
                       Pets = new Pet[] { }},
          new Person { LastName = "Philips",
                       Pets = new Pet[] { new Pet { Name = "Sweetie", Age = 2},
                                          new Pet { Name = "Rover", Age = 13}} }
        };

    // Determine which people have a non-empty Pet array.
    IEnumerable<string> names = from person in people
                                where person.Pets.Any()
                                select person.LastName;

    foreach (string name in names)
    {
        Console.WriteLine(name);
    }

    /* This code produces the following output:

       Haas
       Fakhouri
       Philips
    */
}

Комментарии

Примечание

Этот метод не возвращает ни одного элемента коллекции. Вместо этого он определяет, содержит ли коллекция какие-либо элементы.

Перечисление source останавливается, как только можно определить результат.

В синтаксисе Aggregate Into Any() выражения запроса Visual Basic предложение преобразуется в вызов Any.

См. также раздел

• Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)
• Предложение Aggregate (Visual Basic)

Any<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>)

Исходный код:

AnyAll.cs

Проверяет, удовлетворяет ли какой-либо элемент последовательности заданному условию.

C#

public static bool Any<TSource> (this System.Collections.Generic.IEnumerable<TSource> source, Func<TSource,bool> predicate);

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

TSource

Тип элементов source.

Параметры

source

IEnumerable<TSource>

Объект IEnumerable<T>, к элементам которого применяется предикат.

predicate

Func<TSource,Boolean>

Функция для проверки каждого элемента на соответствие условию.

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

Boolean

true, если исходная последовательность не является пустой и хотя бы один из ее элементов проходит проверку, определяемую указанным предикатом. В противном случае — false.

Исключения

ArgumentNullException

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

Примеры

В следующем примере кода показано, как с помощью Any определить, удовлетворяет ли какой-либо элемент в последовательности условию.

C#

class Pet
{
    public string Name { get; set; }
    public int Age { get; set; }
    public bool Vaccinated { get; set; }
}

public static void AnyEx3()
{
    // Create an array of Pets.
    Pet[] pets =
        { new Pet { Name="Barley", Age=8, Vaccinated=true },
          new Pet { Name="Boots", Age=4, Vaccinated=false },
          new Pet { Name="Whiskers", Age=1, Vaccinated=false } };

    // Determine whether any pets over age 1 are also unvaccinated.
    bool unvaccinated =
        pets.Any(p => p.Age > 1 && p.Vaccinated == false);

    Console.WriteLine(
        "There {0} unvaccinated animals over age one.",
        unvaccinated ? "are" : "are not any");
}

// This code produces the following output:
//
//  There are unvaccinated animals over age one.

Комментарии

Примечание

Этот метод не возвращает ни одного элемента коллекции. Вместо этого он определяет, соответствуют ли какие-либо элементы коллекции условию.

Перечисление source останавливается, как только можно определить результат.

В синтаксисе Aggregate Into Any() выражения запроса Visual Basic предложение преобразуется в вызов Any.

См. также раздел

• Предложение Aggregate (Visual Basic)