IIncludableQueryable<TEntity,TProperty> インターフェイス

定義

クエリ可能な Include/ThenInclude チェーン演算子をサポートします。

public interface IIncludableQueryable<out TEntity,out TProperty> : System.Collections.Generic.IEnumerable<out TEntity>, System.Linq.IQueryable<out TEntity>
type IIncludableQueryable<'Entity, 'Property> = interface
    interface IQueryable<'Entity>
    interface seq<'Entity>
    interface IEnumerable
    interface IQueryable
Public Interface IIncludableQueryable(Of Out TEntity, Out TProperty)
Implements IEnumerable(Of Out TEntity), IQueryable(Of Out TEntity)

型パラメーター

TEntity

エンティティの型。

この型パラメーターは共変です。 つまり、指定した型、または強い派生型のいずれかを使用することができます。 共変性および反変性の詳細については、「ジェネリックの共変性と反変性」をご覧ください。
TProperty

プロパティの型。

この型パラメーターは共変です。 つまり、指定した型、または強い派生型のいずれかを使用することができます。 共変性および反変性の詳細については、「ジェネリックの共変性と反変性」をご覧ください。
実装

注釈

詳細と例については、「 データベース プロバイダーと拡張機能の実装 」および 「EF Core クエリのしくみ 」を参照してください。

拡張メソッド

WithPartitionKey<TEntity>(IQueryable<TEntity>, String)

クエリに使用するパーティションのパーティション キーを指定します。 認証用のパーティション キーに基づいてアクセス許可を提供するリソース トークンを使用する場合に必要です。

AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

シーケンスのすべての要素が条件を満たすかどうかを非同期的に判断します。

AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

シーケンスの要素が条件を満たすかどうかを非同期的に判断します。

AnyAsync<TSource>(IQueryable<TSource>, CancellationToken)

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

AsAsyncEnumerable<TSource>(IQueryable<TSource>)

非同期的に列挙できる を IAsyncEnumerable<T> 返します。

AsNoTracking<TEntity>(IQueryable<TEntity>)

変更トラッカーは、LINQ クエリから返されるエンティティを追跡しません。 エンティティ インスタンスが変更された場合、これは変更トラッカーによって検出されず、 SaveChanges() それらの変更はデータベースに保持されません。

AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)

変更トラッカーは、LINQ クエリから返されるエンティティを追跡しません。 エンティティ インスタンスが変更された場合、これは変更トラッカーによって検出されず、 SaveChanges() それらの変更はデータベースに保持されません。

AsTracking<TEntity>(IQueryable<TEntity>)

変更トラッカーが返されるすべてのエンティティの変更を追跡する新しいクエリを返します。 エンティティ インスタンスに対する変更は、 の間 SaveChanges()に検出され、データベースに永続化されます。

AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior)

'track' パラメーターの値に応じて、変更トラッカーが返されるすべてのエンティティの変更を追跡するか、または返されない新しいクエリを返します。 追跡時に、エンティティ インスタンスに対する変更が検出され、 中 SaveChanges()にデータベースに永続化されます。 追跡しない場合、エンティティ インスタンスが変更された場合、これは変更トラッカーによって検出されず、 SaveChanges() それらの変更はデータベースに保持されません。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの平均を非同期的に計算します。

ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken)

既定の等値比較子を使用して、シーケンスに指定された要素が含まれているかどうかを非同期的に判断します。

CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

条件を満たすシーケンス内の要素の数を非同期的に返します。

CountAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンス内の要素の数を非同期的に返します。

ElementAtAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

シーケンス内の指定したインデックス位置にある 要素を非同期的に返します。

ElementAtOrDefaultAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

シーケンス内の指定したインデックス位置にある 要素を非同期的に返します。インデックスが範囲外の場合は既定値を返します。

FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

指定した条件を満たすシーケンスの最初の要素を非同期的に返します。

FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンスの最初の要素を非同期的に返します。

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

指定した条件を満たすシーケンスの最初の要素、またはそのような要素が見つからない場合は既定値を非同期的に返します。

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンスの最初の要素を非同期的に返します。シーケンスに要素が含まれない場合は既定値を返します。

ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken)

クエリ結果を非同期的に列挙し、各要素に対して指定されたアクションを実行します。

IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)

現在の Entity Framework LINQ クエリに、モデル レベルの一括読み込みナビゲーションを適用しないように指定します。

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

現在の Entity Framework LINQ クエリにモデル レベルのエンティティ クエリ フィルターを適用しないように指定します。

Include<TEntity>(IQueryable<TEntity>, String)

クエリ結果に含める関連エンティティを指定します。 含めるナビゲーション プロパティは、クエリ対象のエンティティの種類 (TEntity) から始めて指定されます。 追加するナビゲーション プロパティは、'.' 文字で区切って追加できます。

Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)

クエリ結果に含める関連エンティティを指定します。 含めるナビゲーション プロパティは、クエリ対象のエンティティの種類 (TEntity) から始めて指定されます。 含める型のナビゲーション プロパティに基づいて追加の型を含める場合は、この呼び出しの後に の呼び出しを ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) チェーンします。

LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

指定した条件を満たすシーケンスの最後の要素を非同期的に返します。

LastAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンスの最後の要素を非同期的に返します。

LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

指定した条件を満たすシーケンスの最後の要素、またはそのような要素が見つからない場合は既定値を非同期的に返します。

LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンスの最後の要素を非同期的に返します。シーケンスに要素が含まれない場合は既定値を返します。

Load<TSource>(IQueryable<TSource>)

クエリを列挙します。 Entity Framework を使用すると、クエリの結果が関連付けられたコンテキストに読み込まれます。 これは、ToList を呼び出してからリストを捨てるのと同じです (実際にリストを作成するオーバーヘッドはありません)。

LoadAsync<TSource>(IQueryable<TSource>, CancellationToken)

クエリを非同期的に列挙します。 Entity Framework を使用すると、クエリの結果が関連付けられたコンテキストに読み込まれます。 これは、ToList を呼び出してからリストを捨てるのと同じです (実際にリストを作成するオーバーヘッドはありません)。

LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

条件を Int64 満たすシーケンス内の要素の数を表す を非同期的に返します。

LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンス内の Int64 要素の合計数を表す を非同期的に返します。

MaxAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンスの最大値を非同期的に返します。

MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

シーケンスの各要素に対してプロジェクション関数を非同期的に呼び出し、結果の最大値を返します。

MinAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンスの最小値を非同期的に返します。

MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

シーケンスの各要素に対してプロジェクション関数を非同期的に呼び出し、結果の最小値を返します。

SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

指定した条件を満たすシーケンスの唯一の要素を非同期的に返し、そのような要素が複数存在する場合は例外をスローします。

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンスの唯一の要素を非同期的に返し、シーケンスに要素が 1 つしかない場合は例外をスローします。

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

指定した条件を満たすシーケンスの唯一の要素、またはそのような要素が存在しない場合は既定値を非同期的に返します。このメソッドは、複数の要素が条件を満たす場合に例外をスローします。

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

シーケンスの唯一の要素を非同期的に返します。シーケンスが空の場合は既定値を返します。シーケンスに複数の要素がある場合、このメソッドは例外をスローします。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

入力シーケンスの各要素に対してプロジェクション関数を呼び出すことによって取得される値のシーケンスの合計を非同期的に計算します。

TagWith<T>(IQueryable<T>, String)

EF LINQ クエリに関連付けられているタグのコレクションにタグを追加します。 タグは、クエリ パイプラインのさまざまなポイントでコンテキスト トレース情報を提供できるクエリ注釈です。

TagWithCallSite<T>(IQueryable<T>, String, Int32)

ソース ファイル名とメソッドが呼び出された行を含む、EF LINQ クエリに関連付けられているタグのコレクションにタグを追加します。この行では、クエリ パイプライン内のさまざまなポイントでコンテキスト トレース情報を提供できます。

ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,TPreviousProperty>, Expression<Func<TPreviousProperty,TProperty>>)

含めたばかりの関連する型に基づいて、さらに含める追加の関連データを指定します。

ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken)

非同期的に列挙することで、 IQueryable<T> から配列を作成します。

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken)

Dictionary<TKey,TValue>指定したキー セレクター関数と比較子に従って非同期的に列挙することによって、 から IQueryable<T> を作成します。

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken)

Dictionary<TKey,TValue>指定したキー セレクター関数に従って非同期的に列挙することによって、 から IQueryable<T> を作成します。

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken)

Dictionary<TKey,TValue>指定したキー セレクター関数、比較子、および要素セレクター関数に従って非同期的に列挙することによって、 から IQueryable<T> を作成します。

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken)

Dictionary<TKey,TValue>指定したキー セレクターと要素セレクター関数に従って非同期的に列挙することによって、 から IQueryable<T> を作成します。

ToListAsync<TSource>(IQueryable<TSource>, CancellationToken)

を非同期的に列挙することで、 から IQueryable<T> を非同期的に作成List<T>します。

AsSingleQuery<TEntity>(IQueryable<TEntity>)

クエリ結果にコレクションを読み込むよう構成された新しいクエリを 1 つのデータベース クエリで返します。

AsSplitQuery<TEntity>(IQueryable<TEntity>)

個別のデータベース クエリを使用してクエリ結果にコレクションを読み込むよう構成された新しいクエリを返します。

ExecuteDelete<TSource>(IQueryable<TSource>)

LINQ クエリに一致するエンティティ インスタンスのすべてのデータベース行をデータベースから削除します。

ExecuteDeleteAsync<TSource>(IQueryable<TSource>, CancellationToken)

LINQ クエリに一致するエンティティ インスタンスのデータベース行を非同期的にデータベースから削除します。

ExecuteUpdate<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>)

データベースの LINQ クエリと一致するエンティティ インスタンスのすべてのデータベース行を更新します。

ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>, CancellationToken)

データベースの LINQ クエリに一致するエンティティ インスタンスのデータベース行を非同期的に更新します。

FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])
互換性のために残されています。.

生の SQL クエリに基づいて LINQ クエリを作成します。

データベース プロバイダーが指定された SQL での作成をサポートしている場合は、LINQ 演算子 ( ) context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)を使用して、生の SQL クエリの上に作成できます。

SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するために、ユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーター プレース ホルダーを含め、追加の引数としてパラメーター値を指定できます。 指定したパラメーター値は、自動的に DbParameter - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)に変換されます。

このオーバーロードでは、DbParameter インスタンスもパラメーター値として受け入れられます。 これにより、SQL クエリ文字列で名前付きパラメーターを使用できます。 context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

FromSql<TEntity>(IQueryable<TEntity>, FormattableString)
互換性のために残されています。.

SQL クエリを表す補間文字列に基づいて LINQ クエリを作成します。

データベース プロバイダーが指定された SQL での作成をサポートしている場合は、LINQ 演算子 ( ) context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)を使用して、生の SQL クエリの上に作成できます。

SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するために、ユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列には、補間パラメーターのプレース ホルダーを含めることができます。 指定した補間パラメーター値は、自動的に DbParameter - context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")に変換されます。

FromSql<TEntity>(IQueryable<TEntity>, String, Object[])

生の SQL クエリに基づいて LINQ クエリを作成します。

データベース プロバイダーが指定された SQL での作成をサポートしている場合は、LINQ 演算子 ( ) context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)を使用して、生の SQL クエリの上に作成できます。

SQL を受け入れる API と同様に、SQL インジェクション攻撃から保護するために、ユーザー入力をパラメーター化することが重要です。 SQL クエリ文字列にパラメーター プレース ホルダーを含め、追加の引数としてパラメーター値を指定できます。 指定したパラメーター値は、自動的に DbParameter - context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm)に変換されます。

DbParameter を構築し、パラメーター値として に指定することもできます。 これにより、SQL クエリ文字列で名前付きパラメーターを使用できます。 context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

適用対象