語言

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 查詢如何運作 」。

擴充方法

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

非同步判斷序列中的所有元素是否滿足某一條件。

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

非同步判斷序列是否包含任何元素。

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

非同步判斷序列中任一元素是否滿足某條件。

AsAsyncEnumerable<TSource>(IQueryable<TSource>)

回傳 和 IAsyncEnumerable<T> ,可非同步列舉。

AsNoTracking<TEntity>(IQueryable<TEntity>)

變更追蹤器不會追蹤從 LINQ 查詢回傳的任何實體。 若實體實例被修改,變更追蹤器不會偵測到,且 SaveChanges() 這些變更不會持久化到資料庫中。

AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)

變更追蹤器不會追蹤從 LINQ 查詢回傳的任何實體。 若實體實例被修改,變更追蹤器不會偵測到,且 SaveChanges() 這些變更不會持久化到資料庫中。

AsSingleQuery<TEntity>(IQueryable<TEntity>)

回傳一個新查詢,該查詢設定為將查詢結果中的集合匯入單一資料庫查詢。

AsSplitQuery<TEntity>(IQueryable<TEntity>)

回傳一個新查詢,並設定為透過獨立資料庫查詢載入查詢結果中的集合。

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

會回傳一個新查詢,變更追蹤器會根據「追蹤」參數的值,對所有回傳的實體都會追蹤變更,或不會追蹤。 在追蹤時,任何對實體實例的修改都會被偵測並持續保存到資料庫中。SaveChanges() 當不追蹤時,若實體實例被修改,變更追蹤器不會偵測到,且 SaveChanges() 這些變更不會持久化到資料庫中。

AsTracking<TEntity>(IQueryable<TEntity>)

回傳一個新查詢,變更追蹤器會追蹤所有回傳實體的變更。 任何對實體實例的修改都會被偵測到,並在 期間持續存在資料庫 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>, CancellationToken)

非同步回傳序列中的元素數量。

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

非同步回傳序列中滿足條件的元素數量。

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

非同步回傳序列中指定索引的元素。

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

非同步回傳序列中指定索引的元素,若索引超出範圍則回傳預設值。

ExecuteDelete<TSource>(IQueryable<TSource>)

刪除所有與 LINQ 查詢相符實體實例的資料庫列。

ExecuteDelete<TSource>(IQueryable<TSource>)

刪除所有與 LINQ 查詢相符實體實例的資料庫列。

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

非同步刪除與 LINQ 查詢相符的實體實例的資料庫列。

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

非同步刪除與 LINQ 查詢相符的實體實例的資料庫列。

ExecuteUpdate<TSource>(IQueryable<TSource>, Action<UpdateSettersBuilder<TSource>>)

更新所有與資料庫 LINQ 查詢相符實體實例的資料庫資料列。

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

更新所有與資料庫 LINQ 查詢相符實體實例的資料庫資料列。

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

更新所有與資料庫 LINQ 查詢相符實體實例的資料庫資料列。

ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Action<UpdateSettersBuilder<TSource>>, CancellationToken)

非同步更新與資料庫 LINQ 查詢相符實體實例的資料庫列。

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

非同步更新與資料庫 LINQ 查詢相符實體實例的資料庫列。

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

非同步更新與資料庫 LINQ 查詢相符實體實例的資料庫列。

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

非同步回傳序列的第一個元素。

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

非同步回傳滿足特定條件的序列中第一個元素。

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

非同步回傳序列的第一個元素,若序列中沒有元素則回傳預設值。

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

非同步回傳序列中第一個符合指定條件的元素,若未找到該元素則回傳預設值。

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

非同步列舉查詢結果,並對每個元素執行指定動作。

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>, 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>, 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))

IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)

規定目前的 Entity Framework LINQ 查詢不應套用任何模型層級的 eager loaded 導覽。

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>, IReadOnlyCollection<String>)

規定目前的實體框架 LINQ 查詢不應套用任何模型層級的實體查詢過濾器。

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

規定目前的實體框架 LINQ 查詢不應套用任何模型層級的實體查詢過濾器。

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

指定相關實體,包含在查詢結果中。 要包含的導航屬性會從被查詢TEntity的實體類型()開始指定。 如果你想根據所包含型別的導航屬性加入更多類型,請在此呼叫後串接呼叫至 ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) 。

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

指定相關實體,包含在查詢結果中。 要包含的導航屬性會從被查詢TEntity的實體類型()開始指定。 其他需包含的導航屬性可附加,並以 '.' 字元分隔。

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

非同步回傳序列的最後一個元素。

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

非同步回傳序列中滿足特定條件的最後一個元素。

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

非同步回傳序列的最後一個元素,若序列中無元素則回傳預設值。

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

非同步回傳序列中滿足特定條件的最後一個元素,若找不到該元素則回傳預設值。

Load<TSource>(IQueryable<TSource>)

列舉查詢。 使用實體框架時,查詢結果會被載入到相關上下文中。 這相當於呼叫 ToList,然後丟棄清單(但沒有實際建立清單的額外負擔)。

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

非同步列舉查詢。 使用實體框架時,查詢結果會被載入到相關上下文中。 這相當於呼叫 ToList,然後丟棄清單(但沒有實際建立清單的額外負擔)。

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

非同步回傳代表序列中元素總數的 a Int64 。

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

非同步回傳 a Int64 ,代表序列中滿足條件的元素數量。

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

非同步地對序列中的每個元素呼叫投影函數,並回傳最大結果值。

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

非同步回傳序列的最大值。

MaxByAsync<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, CancellationToken)

非同步回傳根據指定的鍵選擇函式,在通用中 IQueryable<T> 最大值。

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

非同步地對序列中的每個元素呼叫投影函數,並回傳最小結果值。

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

非同步回傳序列的最小值。

MinByAsync<TSource,TKey>(IQueryable<TSource>, Expression<Func<TSource,TKey>>, CancellationToken)

非同步回傳根據指定的鍵選擇函式,將通用的 IQueryable<T> 最小值回傳。

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

非同步回傳序列中唯一的元素,若序列中沒有恰好一個元素則拋出例外。

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

非同步回傳序列中唯一符合特定條件的元素,若存在多個此類元素則拋出例外。

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

非同步回傳序列中唯一的元素,若序列為空則回傳預設值;此方法若序列中有多個元素,會拋出例外。

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, 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,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken)

透過非同步列舉,依照指定的鍵選擇器與元素選擇函式,從 建立 a Dictionary<TKey,TValue>IQueryable<T> 。

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

透過非同步列舉,依照指定的鍵選擇函數、比較器及元素選擇函式,從 和 IQueryable<T> 建立 aDictionary<TKey,TValue>。

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

透過非同步列舉,依照指定的鍵選擇函式從 中IQueryable<T>建立 aDictionary<TKey,TValue>。

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

透過非同步列舉,根據指定的金鑰選擇函式與比較器,從 和 IQueryable<T> 建立 。Dictionary<TKey,TValue>

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

非同步地從 中IQueryable<T>建立 aHashSet<T>,方法是透過非同步列舉它。

ToHashSetAsync<TSource>(IQueryable<TSource>, IEqualityComparer<TSource>, CancellationToken)

非同步地從 中IQueryable<T>建立 aHashSet<T>,方法是透過非同步列舉它。

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

非同步地從 中IQueryable<T>建立 aList<T>,方法是透過非同步列舉它。

ToPageAsync<TSource>(IQueryable<TSource>, Int32, String, Nullable<Int32>, CancellationToken)

允許透過重複執行相同查詢來分頁查詢結果,傳遞續寫標記以檢索結果集的連續頁面,並指定每頁最大結果數量。

WithApproximate<T>(IQueryable<T>)

啟用向量搜尋查詢的近似最近鄰(ANN)搜尋。 這會導致 WITH APPROXIMATE 加入 SQL TOP 子句,指示 SQL Server 使用向量索引以提升效能。

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

指定用於查詢的分割鍵。 當使用基於分割金鑰提供權限的資源憑證時,必須如此操作,

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

指定用於查詢的分割鍵。 當使用基於分割金鑰提供權限的資源憑證時,必須如此操作,

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

指定用於查詢的分割鍵。 當使用基於分割金鑰提供權限的資源憑證時,必須如此操作,

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

指定用於查詢的分割鍵。 當使用基於分割金鑰提供權限的資源憑證時,必須如此操作,

適用於