Auf Englisch lesen

Freigeben über


Enumerable.Any Methode

Definition

Bestimmt, ob ein Element einer Sequenz vorhanden ist oder eine Bedingung erfüllt

Überlädt

Any<TSource>(IEnumerable<TSource>)

Bestimmt, ob eine Sequenz Elemente enthält.

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

Bestimmt, ob ein Element einer Sequenz eine Bedingung erfüllt.

Any<TSource>(IEnumerable<TSource>)

Quelle:
AnyAll.cs
Quelle:
AnyAll.cs
Quelle:
AnyAll.cs

Bestimmt, ob eine Sequenz Elemente enthält.

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IEnumerable<TSource>

Das IEnumerable<T>, bei dem überprüft werden soll, ob es leer ist.

Gibt zurück

true, wenn die Quellsequenz Elemente enthält, andernfalls false.

Ausnahmen

source ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie verwenden Any , um zu bestimmen, ob eine Sequenz Elemente enthält.

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.

Der boolesche Wert, den die Any<TSource>(IEnumerable<TSource>) Methode zurückgibt, wird in der Regel im Prädikat einer where -Klausel (Where -Klausel in Visual Basic) oder einem direkten Aufruf der Where<TSource>(IEnumerable<TSource>, Func<TSource,Boolean>) -Methode verwendet. Im folgenden Beispiel wird diese Verwendung der Any -Methode veranschaulicht.

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
    */
}

Hinweise

Hinweis

Diese Methode gibt kein Element einer Auflistung zurück. Stattdessen wird bestimmt, ob die Auflistung Elemente enthält.

Die Enumeration von source wird beendet, sobald das Ergebnis ermittelt werden kann.

In der Visual Basic-Abfrageausdruckssyntax wird eine Aggregate Into Any() -Klausel in einen Aufruf von Anyübersetzt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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>)

Quelle:
AnyAll.cs
Quelle:
AnyAll.cs
Quelle:
AnyAll.cs

Bestimmt, ob ein Element einer Sequenz eine Bedingung erfüllt.

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

Typparameter

TSource

Der Typ der Elemente von source.

Parameter

source
IEnumerable<TSource>

Ein IEnumerable<T>, auf dessen Elemente das Prädikat angewendet werden soll.

predicate
Func<TSource,Boolean>

Eine Funktion, mit der jedes Element auf eine Bedingung überprüft wird.

Gibt zurück

true, wenn die Quellsequenz nicht leer ist und mindestens ein Element im angegebenen Prädikat erfolgreich überprüft wird; andernfalls false.

Ausnahmen

source oder predicate ist null.

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie sie verwenden Any , um zu bestimmen, ob ein Element in einer Sequenz eine Bedingung erfüllt.

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.

Hinweise

Hinweis

Diese Methode gibt kein Element einer Auflistung zurück. Stattdessen wird bestimmt, ob Elemente einer Auflistung eine Bedingung erfüllen.

Die Enumeration von source wird beendet, sobald das Ergebnis ermittelt werden kann.

In der Visual Basic-Abfrageausdruckssyntax wird eine Aggregate Into Any() -Klausel in einen Aufruf von Anyübersetzt.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.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