Enumerable.Any 方法

定义

确定序列中是否包含元素或存在元素满足指定条件。

重载

Any<TSource>(IEnumerable<TSource>)

确定序列是否包含任何元素。

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

确定序列中是否存在任意一个元素满足条件。

Any<TSource>(IEnumerable<TSource>)

Source:
AnyAll.cs
Source:
AnyAll.cs
Source:
AnyAll.cs

确定序列是否包含任何元素。

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

类型参数

TSource

source 的元素类型。

参数

source
IEnumerable<TSource>

要检查是否为空的 IEnumerable<T>

返回

如果源序列包含任何元素,则为 true;否则为 false

例外

sourcenull

示例

下面的代码示例演示如何使用 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>)通常用于 Visual Basic) 中子句 (Where 子句的谓词where或对 方法的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 枚举。

在 Visual Basic 查询表达式语法中, Aggregate Into Any() 子句转换为 的调用 Any

另请参阅

适用于

.NET 9 和其他版本
产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

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

Source:
AnyAll.cs
Source:
AnyAll.cs
Source:
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>

用于测试每个元素是否满足条件的函数。

返回

如果源序列不为空,并且至少有一个元素通过指定谓词中的测试,则为 true;否则为 false

例外

sourcepredicatenull

示例

下面的代码示例演示如何使用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 枚举。

在 Visual Basic 查询表达式语法中, Aggregate Into Any() 子句转换为 的调用 Any

另请参阅

适用于

.NET 9 和其他版本
产品 版本
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0