Share via


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)

以非同步方式傳回序列的唯一元素,如果序列中沒有一個專案,則會擲回例外狀況。

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

傳回新的查詢,其設定為在單一資料庫查詢中載入查詢結果中的集合。

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 運算子在原始 SQL 查詢之上撰寫 - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)

如同接受 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 運算子在原始 SQL 查詢之上撰寫 - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)

如同接受 SQL 的任何 API,請務必將任何使用者輸入參數化,以防止 SQL 插入式攻擊。 您可以在 SQL 查詢字串中包含插補參數預留位置。 您提供的任何插補參數值都會自動轉換成 DbParameter - context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})")

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

根據原始 SQL 查詢建立 LINQ 查詢。

如果資料庫提供者支援在提供的 SQL 上撰寫,您可以使用 LINQ 運算子在原始 SQL 查詢之上撰寫 - context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name)

如同接受 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))

適用於