IDbSet<TEntity> 介面

定義

命名空間:

System.Data.Entity

組件:

EntityFramework.dll

IDbSet<TEntity>表示內容中所有實體的集合，或可從指定型別的資料庫查詢的所有實體集合。 DbSet<TEntity> 是 IDbSet 的具體實作。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification="Name is intentional")]
public interface IDbSet<TEntity> : System.Collections.Generic.IEnumerable<TEntity>, System.Linq.IQueryable<TEntity> where TEntity : class

type IDbSet<'Entity (requires 'Entity : null)> = interface
    interface IQueryable<'Entity (requires 'Entity : null)>
    interface seq<'Entity (requires 'Entity : null)>
    interface IQueryable
    interface IEnumerable

Public Interface IDbSet(Of TEntity)
Implements IEnumerable(Of TEntity), IQueryable(Of TEntity)

類型參數

TEntity

定義集合的型別。

衍生

System.Data.Entity.DbSet<TEntity>

實作

IEnumerable<T> IEnumerable<TEntity> IEnumerable IQueryable IQueryable<TEntity>

備註

IDbSet<TEntity> 原本是為了允許針對 建立測試雙精度浮點數 (模擬或假) DbSet<TEntity> 。 不過，此方法有一個問題是，將新成員新增至介面會中斷現有的程式碼，而該程式碼已實作介面，而不需要新的成員。 因此，從 EF6 開始，不會將新成員新增至此介面，因此建議 DbSet<TEntity> 用來作為測試雙精度浮點數的基類。

屬性

Local

取得 ， ObservableCollection<T> 表示這個集合中所有新增、未變更和修改實體的本機檢視。 當從內容中加入或移除實體時，這個本機檢視會維持同步的狀態。 同樣地，從本機檢視加入或移除的實體將會自動加入至內容中或是從內容中移除。

方法

Add(TEntity)	將給定的實體加入至 Added 狀態中集合底層的內容，好讓呼叫 SaveChanges 時可將它插入資料庫中。
Attach(TEntity)	將給定的實體附加至集合底層的內容。 也就是說，此實體會放在 Unchanged 狀態的內容中，就像是已經從資料庫讀取一樣。
Create()	針對這個集合的型別建立實體的新執行個體。 請注意，此實例不會新增或附加至集合。 如果設定基礎內容建立 Proxy 而且實體型別符合建立 Proxy 的需求，則傳回的執行個體將會是 Proxy。
Create<TDerivedEntity>()	針對這個集合的型別或是衍生自這個集合之型別的型別，建立實體的新執行個體。 請注意，此實例不會新增或附加至集合。 如果設定基礎內容建立 Proxy 而且實體型別符合建立 Proxy 的需求，則傳回的執行個體將會是 Proxy。
Find(Object[])	尋找具有給定主索引鍵值的實體。 如果具有給定主索引鍵值的實體存在於內容中，則會立刻傳回此實體，而不會對存放區發出要求。 同樣地，如果是具有給定主索引鍵值的實體，則會對存放區發出要求，而且如果找到這個實體，則會將它附加至內容中並傳回。 如果內容或存放區中找不到任何實體，則會傳回 null。
Remove(TEntity)	將給定的實體標記為 Deleted，好讓呼叫 SaveChanges 時可從資料庫中將它刪除。 請注意，此實體必須存在於某個其他狀態的內容中，然後才會呼叫這個方法。

擴充方法

AddOrUpdate<TEntity>(IDbSet<TEntity>, TEntity[])	呼叫 SaveChanges 時，依索引鍵新增或更新實體。 相當於資料庫術語中的「upsert」作業。 這個方法在使用移轉植入資料時很有用。
AddOrUpdate<TEntity>(IDbSet<TEntity>, Expression<Func<TEntity,Object>>, TEntity[])	呼叫 SaveChanges 時，透過自訂識別運算式新增或更新實體。 相當於資料庫術語中的「upsert」作業。 這個方法在使用移轉植入資料時很有用。
AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式判斷序列的所有專案是否符合條件。
AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式判斷序列的所有專案是否符合條件。
AnyAsync<TSource>(IQueryable<TSource>)	以非同步方式判斷序列是否包含任何專案。
AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式判斷序列的任何專案是否符合條件。
AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式判斷序列的任何專案是否符合條件。
AnyAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式判斷序列是否包含任何專案。
AsNoTracking<T>(IQueryable<T>)	傳回新的查詢，其中傳回的實體將不會在 或 ObjectContext 中 DbContext 快取。 這個方法的運作方式是藉由呼叫基礎查詢物件的 AsNoTracking 方法。 如果基礎查詢物件沒有 AsNoTracking 方法，則呼叫這個方法將不會有任何影響。
AsStreaming<T>(IQueryable<T>)	已淘汰. 傳回新的查詢，此查詢會串流結果，而不是緩衝處理。 這個方法的運作方式是呼叫基礎查詢物件的 AsStreaming 方法。 如果基礎查詢物件沒有 AsStreaming 方法，則呼叫這個方法將不會有任何影響。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Decimal 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Decimal 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Double 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Double 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Int32 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Int32 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Int64 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Int64 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Decimal Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Decimal Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Double Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Double Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Int32 Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Int32 Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Int64 Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Int64 Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Single Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之可為 Single Null 值的序列平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Single 的平均值。
AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)	以非同步方式計算輸入序列上叫用投影函式所取得之值序列 Single 的平均值。
ContainsAsync<TSource>(IQueryable<TSource>, TSource)	使用預設相等比較子，以非同步方式判斷序列是否包含指定的專案。
ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken)	使用預設相等比較子，以非同步方式判斷序列是否包含指定的專案。
CountAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回序列中的專案數目。
CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式傳回序列中滿足條件的專案數。
CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式傳回序列中滿足條件的專案數。
CountAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列中的專案數目。
FirstAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回序列的第一個專案。
FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式傳回符合指定條件之序列的第一個專案。
FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式傳回符合指定條件之序列的第一個專案。
FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列的第一個專案。
FirstOrDefaultAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回序列的第一個專案，如果序列不包含任何專案，則傳回預設值。
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式傳回符合指定條件之序列的第一個專案，如果沒有找到這類專案，則傳回預設值。
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式傳回符合指定條件之序列的第一個專案，如果沒有找到這類專案，則傳回預設值。
FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列的第一個專案，如果序列不包含任何專案，則傳回預設值。
ForEachAsync<T>(IQueryable<T>, Action<T>)	以非同步方式列舉查詢結果，並在每個專案上執行指定的動作。
ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken)	以非同步方式列舉查詢結果，並在每個專案上執行指定的動作。
Include<T>(IQueryable<T>, String)	指定要包含在查詢結果中的相關物件。
Include<T,TProperty>(IQueryable<T>, Expression<Func<T,TProperty>>)	指定要包含在查詢結果中的相關物件。
LongCountAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回 ， Int64 表示序列中的專案總數。
LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式傳回 ， Int64 表示序列中滿足條件的專案數。
LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式傳回 ， Int64 表示序列中滿足條件的專案數。
LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回 ， Int64 表示序列中的專案總數。
MaxAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回序列的最大值。
MaxAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列的最大值。
MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>)	以非同步方式在序列的每個專案上叫用投影函式，並傳回產生的最大值。
MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)	以非同步方式在序列的每個專案上叫用投影函式，並傳回產生的最大值。
MinAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回序列的最小值。
MinAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列的最小值。
MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>)	以非同步方式在序列的每個專案上叫用投影函式，並傳回最小產生的值。
MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)	以非同步方式在序列的每個元素上叫用投影函式，並傳回產生的最小值。
SingleAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回序列的唯一元素，如果序列中沒有一個專案，則會擲回例外狀況。
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式傳回符合指定條件之序列的唯一元素，如果有多個這類專案存在，則會擲回例外狀況。
SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式傳回符合指定條件之序列的唯一元素，如果有多個這類專案存在，則會擲回例外狀況。
SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列的唯一元素，如果序列中沒有一個專案，則會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>)	以非同步方式傳回序列的唯一元素;如果序列是空的，則傳回預設值;如果序列中有一個以上的元素，這個方法就會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>)	以非同步方式傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果多個元素符合條件，這個方法就會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)	以非同步方式傳回序列中唯一符合指定條件的專案，如果沒有這類專案，則傳回預設值;如果多個元素符合條件，這個方法就會擲回例外狀況。
SingleOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式傳回序列的唯一元素;如果序列是空的，則傳回預設值;如果序列中有一個以上的元素，這個方法就會擲回例外狀況。
Skip<TSource>(IQueryable<TSource>, Expression<Func<Int32>>)	略過序列中指定的項目數目，然後傳回其餘項目。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Decimal 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Decimal 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Double 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Double 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Int32 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Int32 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Int64 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Int64 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Decimal 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Decimal 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Double 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Double 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Int32 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Int32 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Int64 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Int64 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Single 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式取得之可為 Null Single 值序列的總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Single 總和。
SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)	以非同步方式計算在輸入序列的每個元素上叫用投影函式所取得的值序列 Single 總和。
Take<TSource>(IQueryable<TSource>, Expression<Func<Int32>>)	從序列開頭傳回指定的連續項目數目。
ToArrayAsync<TSource>(IQueryable<TSource>)	以非同步方式列舉陣列，從 IQueryable<T> 建立陣列。
ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken)	以非同步方式列舉陣列，從 IQueryable<T> 建立陣列。
ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>)	Dictionary<TKey,TValue>根據指定的索引鍵選取器函式以非同步方式列舉，從 IQueryable<T> 建立 。
ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>)	Dictionary<TKey,TValue>根據指定的索引鍵選取器函式和比較子，以非同步方式列舉，從 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>)	Dictionary<TKey,TValue>根據指定的索引鍵選取器和元素選取器函式，以非同步方式列舉，從 IQueryable<T> 建立 。
ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>)	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>)	List<T>以非同步方式列舉 ，從 IQueryable<T> 建立 。
ToListAsync<TSource>(IQueryable<TSource>, CancellationToken)	List<T>以非同步方式列舉 ，從 IQueryable<T> 建立 。