Queryable.Any メソッド

定義

名前空間:

System.Linq

アセンブリ:

System.Linq.Queryable.dll

IQueryable<T> シーケンスの要素が存在するか、または条件を満たすかどうかを判断します。

オーバーロード

Any<TSource>(IQueryable<TSource>)	シーケンスに要素が含まれているかどうかを判断します。
Any<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	シーケンスの任意の要素が条件を満たしているかどうかを判断します。

Any<TSource>(IQueryable<TSource>)

ソース:

Queryable.cs

シーケンスに要素が含まれているかどうかを判断します。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static bool Any(System::Linq::IQueryable<TSource> ^ source);

public static bool Any<TSource> (this System.Linq.IQueryable<TSource> source);

static member Any : System.Linq.IQueryable<'Source> -> bool

<Extension()>
Public Function Any(Of TSource) (source As IQueryable(Of TSource)) As Boolean

型パラメーター

TSource

source の要素の型。

パラメーター

source

IQueryable<TSource>

空かどうかを確認するシーケンス。

戻り値

Boolean

ソース シーケンスに要素が含まれている場合は true。それ以外の場合は false。

例外

ArgumentNullException

source が nullです。

例

次のコード例では、 を使用 Any<TSource>(IQueryable<TSource>) して、シーケンスに要素が含まれているかどうかを判断する方法を示します。

List<int> numbers = new List<int> { 1, 2 };

// Determine if the list contains any elements.
bool hasElements = numbers.AsQueryable().Any();

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

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

Dim numbers As New List(Of Integer)(New Integer() {1, 2})

' Determine if the list contains any elements.
Dim hasElements As Boolean = numbers.AsQueryable().Any()

MsgBox(String.Format("The list {0} empty.", _
    IIf(hasElements, "is not", "is")))

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

メソッドからAny<TSource>(IQueryable<TSource>)返されるブール値は、通常、句 (Where Visual Basic の句) またはメソッドへのWhere<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)直接呼び出しの述語whereで使用されます。 次の例では、 メソッドのこの使用方法を Any 示します。

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.AsQueryable().Any()
                                select person.LastName;

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

    /* This code produces the following output:

       Haas
       Fakhouri
       Philips
    */
}

Structure Pet
    Public Name As String
    Public Age As Integer
End Structure

Structure Person
    Public LastName As String
    Public Pets() As Pet
End Structure

Sub AnyEx2()
    Dim people As New List(Of Person)(New Person() _
        {New Person With {.LastName = "Haas", _
                          .Pets = New Pet() {New Pet With {.Name = "Barley", .Age = 10}, _
                                             New Pet With {.Name = "Boots", .Age = 14}, _
                                             New Pet With {.Name = "Whiskers", .Age = 6}}}, _
          New Person With {.LastName = "Fakhouri", _
                           .Pets = New Pet() {New Pet With {.Name = "Snowball", .Age = 1}}}, _
          New Person With {.LastName = "Antebi", _
                           .Pets = New Pet() {}}, _
          New Person With {.LastName = "Philips", _
                           .Pets = New Pet() {New Pet With {.Name = "Sweetie", .Age = 2}, _
                                              New Pet With {.Name = "Rover", .Age = 13}}}})

    ' Determine which people have a non-empty Pet array.
    Dim names = From person In people _
                Where person.Pets.AsQueryable().Any() _
                Select person.LastName

    For Each name As String In names
        Console.WriteLine(name)
    Next

    ' This code produces the following output:
    '
    ' Haas
    ' Fakhouri
    ' Philips

End Sub

注釈

メソッドは Any<TSource>(IQueryable<TSource>) 、 MethodCallExpression 構築されたジェネリック メソッドとしての呼び出し Any<TSource>(IQueryable<TSource>) 自体を表す を生成します。 次に、 パラメーターの MethodCallExpressionExecute<TResult>(Expression) プロパティで表される の IQueryProvider メソッドに をProvidersource渡します。

呼び出し Any<TSource>(IQueryable<TSource>) を表す式ツリーを実行した結果として発生するクエリ動作は、 パラメーターの型の source 実装によって異なります。 予期される動作は、要素が含まれているかどうかを source 判断することです。

Any<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)

ソース:

Queryable.cs

シーケンスの任意の要素が条件を満たしているかどうかを判断します。

public:
generic <typename TSource>
[System::Runtime::CompilerServices::Extension]
 static bool Any(System::Linq::IQueryable<TSource> ^ source, System::Linq::Expressions::Expression<Func<TSource, bool> ^> ^ predicate);

public static bool Any<TSource> (this System.Linq.IQueryable<TSource> source, System.Linq.Expressions.Expression<Func<TSource,bool>> predicate);

static member Any : System.Linq.IQueryable<'Source> * System.Linq.Expressions.Expression<Func<'Source, bool>> -> bool

<Extension()>
Public Function Any(Of TSource) (source As IQueryable(Of TSource), predicate As Expression(Of Func(Of TSource, Boolean))) As Boolean

型パラメーター

TSource

source の要素の型。

パラメーター

source

IQueryable<TSource>

条件を満たしているかどうかをテストする要素を含むシーケンス。

predicate

Expression<Func<TSource,Boolean>>

各要素が条件を満たしているかどうかをテストする関数。

戻り値

Boolean

指定された述語でソース シーケンスの要素がテストに合格する場合は true。それ以外の場合は false。

例外

ArgumentNullException

source または predicate が null です。

例

次のコード例では、 を使用 Any<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) して、シーケンス内の要素が条件を満たすかどうかを判断する方法を示します。

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 Pet objects.
    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.AsQueryable().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.

Structure Pet
    Dim Name As String
    Dim Age As Integer
    Dim Vaccinated As Boolean
End Structure

Shared Sub AnyEx3()
    ' Create an array of Pet objects.
    Dim pets() As Pet = _
        {New Pet With {.Name = "Barley", .Age = 8, .Vaccinated = True}, _
         New Pet With {.Name = "Boots", .Age = 4, .Vaccinated = False}, _
         New Pet With {.Name = "Whiskers", .Age = 1, .Vaccinated = False}}

    ' Determine whether any pets over age 1 are also unvaccinated.
    Dim unvaccinated As Boolean = _
    pets.AsQueryable().Any(Function(p) p.Age > 1 And p.Vaccinated = False)

    MsgBox(String.Format( _
        "There {0} unvaccinated animals over age one.", _
        IIf(unvaccinated, "are", "are not any") _
    ))
End Sub

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

注釈

このメソッドには、型引数が型 Expression<TDelegate> の 1 つである型のパラメーターが少なくとも 1 つ Func<T,TResult> 含まれています。 これらのパラメーターでは、ラムダ式を渡すと、 に Expression<TDelegate>コンパイルされます。

メソッドは Any<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) 、 MethodCallExpression 構築されたジェネリック メソッドとしての呼び出し Any<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) 自体を表す を生成します。 次に、 パラメーターの MethodCallExpressionExecute<TResult>(Expression) プロパティで表される の IQueryProvider メソッドに をProvidersource渡します。

呼び出し Any<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>) を表す式ツリーを実行した結果として発生するクエリ動作は、 パラメーターの型の source 実装によって異なります。 予期される動作は、 の要素 source のいずれかが で predicate指定された条件を満たすかどうかを判断することです。