語言

DbSqlQuery<TEntity> 類別

定義

代表一個由 建立 DbContext 並利用該上下文連線執行的實體 SQL 查詢。 此類別的實例來自 DbSet<TEntity> 實體類型的實例。 當建立此物件時,查詢並未被執行;每次列舉時都會執行,例如使用 foreach。 非實體的 SQL 查詢則使用 SqlQuery<TElement>(String, Object[])。 請參閱 DbSqlQuery 此類別的非通用版本。

[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1709:IdentifiersShouldBeCasedCorrectly", Justification="FxCop rule is wrong; Db is not an abbreviation for data base.", MessageId="Db")]
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix", Justification="Name is intentional")]
public class DbSqlQuery<TEntity> : System.Data.Entity.Infrastructure.DbRawSqlQuery<TEntity> where TEntity : class
[System.Diagnostics.CodeAnalysis.SuppressMessage("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbSqlQuery<TEntity> : System.Data.Entity.Infrastructure.DbRawSqlQuery<TEntity> where TEntity : class
type DbSqlQuery<'Entity (requires 'Entity : null)> = class
    inherit DbRawSqlQuery<'Entity (requires 'Entity : null)>
Public Class DbSqlQuery(Of TEntity)
Inherits DbRawSqlQuery(Of TEntity)

類型參數

TEntity

查詢回傳的實體類型。

繼承
DbRawSqlQuery<TEntity>
DbSqlQuery<TEntity>
繼承
DbSqlQuery<TEntity>
屬性

建構函式

名稱 Description
DbSqlQuery<TEntity>()

當從導出型別的建構子呼叫時,會建立一個 的 DbSqlQuery<TEntity> 實例,該建構子將用作 的 SqlQuery(String, Object[])測試雙重。 測試雙重所使用的方法與屬性必須由其實作,唯獨 AsNoTracking 和 AsStreaming 預設實作為 no-op。

方法

名稱 Description
AllAsync(Func<TElement,Boolean>, CancellationToken)

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

(繼承來源 DbRawSqlQuery<TElement>)
AllAsync(Func<TElement,Boolean>)

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

(繼承來源 DbRawSqlQuery<TElement>)
AnyAsync()

非同步判斷查詢是否包含任何元素。

(繼承來源 DbRawSqlQuery<TElement>)
AnyAsync(CancellationToken)

非同步判斷查詢是否包含任何元素。

(繼承來源 DbRawSqlQuery<TElement>)
AnyAsync(Func<TElement,Boolean>, CancellationToken)

非同步判斷查詢中的任何元素是否滿足某條件。

(繼承來源 DbRawSqlQuery<TElement>)
AnyAsync(Func<TElement,Boolean>)

非同步判斷查詢中的任何元素是否滿足某條件。

(繼承來源 DbRawSqlQuery<TElement>)
AsNoTracking()

回傳一個新查詢,回傳的實體不會快取在 DbContext。

AsStreaming()
已淘汰.

會回傳一個新的查詢,將結果串流而非緩衝。

ContainsAsync(TElement, CancellationToken)

非同步判斷查詢是否包含特定元素,透過預設的等號比較器。

(繼承來源 DbRawSqlQuery<TElement>)
ContainsAsync(TElement)

非同步判斷查詢是否包含特定元素,透過預設的等號比較器。

(繼承來源 DbRawSqlQuery<TElement>)
CountAsync()

非同步回傳查詢中的元素數量。

(繼承來源 DbRawSqlQuery<TElement>)
CountAsync(CancellationToken)

非同步回傳查詢中的元素數量。

(繼承來源 DbRawSqlQuery<TElement>)
CountAsync(Func<TElement,Boolean>, CancellationToken)

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

(繼承來源 DbRawSqlQuery<TElement>)
CountAsync(Func<TElement,Boolean>)

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

(繼承來源 DbRawSqlQuery<TElement>)
Equals(Object)

代表一個由 建立 DbContext 並利用該上下文連線執行的實體 SQL 查詢。 此類別的實例來自 DbSet<TEntity> 實體類型的實例。 當建立此物件時,查詢並未被執行;每次列舉時都會執行,例如使用 foreach。 非實體的 SQL 查詢則使用 SqlQuery<TElement>(String, Object[])。 請參閱 DbSqlQuery 此類別的非通用版本。

FirstAsync()

非同步回傳查詢的第一個元素。

(繼承來源 DbRawSqlQuery<TElement>)
FirstAsync(CancellationToken)

非同步回傳查詢的第一個元素。

(繼承來源 DbRawSqlQuery<TElement>)
FirstAsync(Func<TElement,Boolean>, CancellationToken)

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

(繼承來源 DbRawSqlQuery<TElement>)
FirstAsync(Func<TElement,Boolean>)

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

(繼承來源 DbRawSqlQuery<TElement>)
FirstOrDefaultAsync()

非同步回傳查詢的第一個元素,若查詢結果中沒有元素則回傳預設值。

(繼承來源 DbRawSqlQuery<TElement>)
FirstOrDefaultAsync(CancellationToken)

非同步回傳查詢的第一個元素,若查詢結果中沒有元素則回傳預設值。

(繼承來源 DbRawSqlQuery<TElement>)
FirstOrDefaultAsync(Func<TElement,Boolean>, CancellationToken)

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

(繼承來源 DbRawSqlQuery<TElement>)
FirstOrDefaultAsync(Func<TElement,Boolean>)

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

(繼承來源 DbRawSqlQuery<TElement>)
ForEachAsync(Action<TElement>, CancellationToken)

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

(繼承來源 DbRawSqlQuery<TElement>)
ForEachAsync(Action<TElement>)

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

(繼承來源 DbRawSqlQuery<TElement>)
GetEnumerator()

執行查詢並回傳元素的枚舉器。

GetEnumerator()

回傳 , IEnumerator<T> 列舉時會對資料庫執行 SQL 查詢。

(繼承來源 DbRawSqlQuery<TElement>)
GetHashCode()

代表一個由 建立 DbContext 並利用該上下文連線執行的實體 SQL 查詢。 此類別的實例來自 DbSet<TEntity> 實體類型的實例。 當建立此物件時,查詢並未被執行;每次列舉時都會執行,例如使用 foreach。 非實體的 SQL 查詢則使用 SqlQuery<TElement>(String, Object[])。 請參閱 DbSqlQuery 此類別的非通用版本。

GetType()

代表一個由 建立 DbContext 並利用該上下文連線執行的實體 SQL 查詢。 此類別的實例來自 DbSet<TEntity> 實體類型的實例。 當建立此物件時,查詢並未被執行;每次列舉時都會執行,例如使用 foreach。 非實體的 SQL 查詢則使用 SqlQuery<TElement>(String, Object[])。 請參閱 DbSqlQuery 此類別的非通用版本。

LongCountAsync()

非同步回傳 和 Int64 代表查詢中元素的總數。

(繼承來源 DbRawSqlQuery<TElement>)
LongCountAsync(CancellationToken)

非同步回傳 和 Int64 代表查詢中元素的總數。

(繼承來源 DbRawSqlQuery<TElement>)
LongCountAsync(Func<TElement,Boolean>, CancellationToken)

非同步回傳 表示 Int64 查詢中滿足條件的元素數量。

(繼承來源 DbRawSqlQuery<TElement>)
LongCountAsync(Func<TElement,Boolean>)

非同步回傳 表示 Int64 查詢中滿足條件的元素數量。

(繼承來源 DbRawSqlQuery<TElement>)
MaxAsync()

非同步回傳查詢的最大值。

(繼承來源 DbRawSqlQuery<TElement>)
MaxAsync(CancellationToken)

非同步回傳查詢的最大值。

(繼承來源 DbRawSqlQuery<TElement>)
MinAsync()

非同步回傳查詢的最小值。

(繼承來源 DbRawSqlQuery<TElement>)
MinAsync(CancellationToken)

非同步回傳查詢的最小值。

(繼承來源 DbRawSqlQuery<TElement>)
SingleAsync()

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

(繼承來源 DbRawSqlQuery<TElement>)
SingleAsync(CancellationToken)

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

(繼承來源 DbRawSqlQuery<TElement>)
SingleAsync(Func<TElement,Boolean>, CancellationToken)

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

(繼承來源 DbRawSqlQuery<TElement>)
SingleAsync(Func<TElement,Boolean>)

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

(繼承來源 DbRawSqlQuery<TElement>)
SingleOrDefaultAsync()

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

(繼承來源 DbRawSqlQuery<TElement>)
SingleOrDefaultAsync(CancellationToken)

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

(繼承來源 DbRawSqlQuery<TElement>)
SingleOrDefaultAsync(Func<TElement,Boolean>, CancellationToken)

非同步回傳查詢中唯一滿足特定條件的元素,若不存在該元素則回傳預設值;此方法若有多個元素符合條件,則拋出例外。

(繼承來源 DbRawSqlQuery<TElement>)
SingleOrDefaultAsync(Func<TElement,Boolean>)

非同步回傳查詢中唯一滿足特定條件的元素,若不存在該元素則回傳預設值;此方法若有多個元素符合條件,則拋出例外。

(繼承來源 DbRawSqlQuery<TElement>)
ToArrayAsync()

透過非同步枚舉查詢產生陣列。

(繼承來源 DbRawSqlQuery<TElement>)
ToArrayAsync(CancellationToken)

透過非同步枚舉查詢產生陣列。

(繼承來源 DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey,TResult>(Func<TElement,TKey>, Func<TElement,TResult>, CancellationToken)

根據指定的鍵選擇器和元素選擇函式,非同步列舉查詢產生 。Dictionary<TKey,TValue>

(繼承來源 DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey,TResult>(Func<TElement,TKey>, Func<TElement,TResult>, IEqualityComparer<TKey>, CancellationToken)

透過非同步列舉查詢,依據指定的鍵選擇函式、比較器及元素選擇函式,從查詢中建立 。Dictionary<TKey,TValue>

(繼承來源 DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey,TResult>(Func<TElement,TKey>, Func<TElement,TResult>, IEqualityComparer<TKey>)

透過非同步列舉查詢,依據指定的鍵選擇函式、比較器及元素選擇函式,從查詢中建立 。Dictionary<TKey,TValue>

(繼承來源 DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey,TResult>(Func<TElement,TKey>, Func<TElement,TResult>)

根據指定的鍵選擇器和元素選擇函式,非同步列舉查詢產生 。Dictionary<TKey,TValue>

(繼承來源 DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey>(Func<TElement,TKey>, CancellationToken)

根據指定的鍵選擇函式,非同步列舉查詢產生 。Dictionary<TKey,TValue>

(繼承來源 DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey>(Func<TElement,TKey>, IEqualityComparer<TKey>, CancellationToken)

透過非同步列舉查詢,依照指定的金鑰選擇函式與比較器,從查詢中建立 。Dictionary<TKey,TValue>

(繼承來源 DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey>(Func<TElement,TKey>, IEqualityComparer<TKey>)

透過非同步列舉查詢,依照指定的金鑰選擇函式與比較器,從查詢中建立 。Dictionary<TKey,TValue>

(繼承來源 DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey>(Func<TElement,TKey>)

根據指定的鍵選擇函式,非同步列舉查詢產生 。Dictionary<TKey,TValue>

(繼承來源 DbRawSqlQuery<TElement>)
ToListAsync()

透過非同步列舉查詢,從查詢中建立 a List<T> 。

(繼承來源 DbRawSqlQuery<TElement>)
ToListAsync(CancellationToken)

透過非同步列舉查詢,從查詢中建立 a List<T> 。

(繼承來源 DbRawSqlQuery<TElement>)
ToString()

回傳包含查詢建立時設定的 SQL 字串的 a String 。 參數未包含在內。

明確介面實作

名稱 Description
IDbAsyncEnumerable.GetAsyncEnumerator()

回傳 , IDbAsyncEnumerable 列舉時會對資料庫執行 SQL 查詢。

(繼承來源 DbRawSqlQuery<TElement>)
IDbAsyncEnumerable<TElement>.GetAsyncEnumerator()

回傳 , IDbAsyncEnumerable<T> 列舉時會對資料庫執行 SQL 查詢。

(繼承來源 DbRawSqlQuery<TElement>)
IEnumerable.GetEnumerator()

執行查詢並回傳元素的枚舉器。

IEnumerable.GetEnumerator()

回傳 , IEnumerator 列舉時會對資料庫執行 SQL 查詢。

(繼承來源 DbRawSqlQuery<TElement>)
IListSource.ContainsListCollection

傳回 false。

IListSource.ContainsListCollection

傳回 false。

(繼承來源 DbRawSqlQuery<TElement>)
IListSource.GetList()

會拋出例外,表示不支援直接綁定到商店查詢。

IListSource.GetList()

會拋出例外,表示不支援直接綁定到商店查詢。

(繼承來源 DbRawSqlQuery<TElement>)

適用於