DbRawSqlQuery<TElement> 類別

  • 發行項

[此頁面專屬於 Entity Framework 第 6 版。最新版本可從 'Entity Framework' NuGet 套件取得。如需 Entity Framework 的詳細資訊，請參閱 msdn.com/data/ef。]

表示非實體的 SQL 查詢，該查詢是從 DbContext 建立而且會使用該內容中的連接來執行。 此類別的執行個體會從 Database 執行個體取得。 建立此物件時不會執行此查詢，每當列舉此查詢時便會執行，例如，藉由使用 foreach。 實體的 SQL 查詢會使用 SqlQuery(String, Object[]) 加以建立。 請參閱 DbRawSqlQuery 以取得此類別的非泛型版本。

繼承階層

System.Object
  System.Data.Entity.Infrastructure.DbRawSqlQuery<TElement>
    System.Data.Entity.Infrastructure.DbSqlQuery<TEntity>

命名空間：  System.Data.Entity.Infrastructure
組件：  EntityFramework (在 EntityFramework.dll 中)

語法

'宣告
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class DbRawSqlQuery(Of TElement) _
    Implements IEnumerable(Of TElement), IEnumerable,  _
    IListSource, IDbAsyncEnumerable(Of TElement), IDbAsyncEnumerable
'用途
Dim instance As DbRawSqlQuery(Of TElement)

[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbRawSqlQuery<TElement> : IEnumerable<TElement>, 
    IEnumerable, IListSource, IDbAsyncEnumerable<TElement>, IDbAsyncEnumerable

[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
generic<typename TElement>
public ref class DbRawSqlQuery : IEnumerable<TElement>, 
    IEnumerable, IListSource, IDbAsyncEnumerable<TElement>, IDbAsyncEnumerable

[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type DbRawSqlQuery<'TElement> =  
    class 
        interface IEnumerable<'TElement>
        interface IEnumerable 
        interface IListSource 
        interface IDbAsyncEnumerable<'TElement>
        interface IDbAsyncEnumerable 
    end

JScript does not support generic types and methods.

類型參數

  • TElement
    查詢傳回之元素的類型。

DbRawSqlQuery<TElement> 類型會公開下列成員。

方法

  名稱 描述
公用方法 AllAsync(Func<TElement, Boolean>) 非同步判斷查詢的所有項目是否都符合條件。
公用方法 AllAsync(Func<TElement, Boolean>, CancellationToken) 非同步判斷查詢的所有項目是否都符合條件。
公用方法 AnyAsync() 非同步判斷查詢是否包含任何項目。
公用方法 AnyAsync(Func<TElement, Boolean>) 非同步判斷查詢的任何項目是否符合條件。
公用方法 AnyAsync(CancellationToken) 非同步判斷查詢是否包含任何項目。
公用方法 AnyAsync(Func<TElement, Boolean>, CancellationToken) 非同步判斷查詢的任何項目是否符合條件。
公用方法 AsStreaming 已過時。 傳回會串流結果而非緩衝處理的新查詢。
公用方法 ContainsAsync(TElement) 使用預設的相等比較子 (Comparer) 來非同步判斷查詢是否包含指定的項目。
公用方法 ContainsAsync(TElement, CancellationToken) 使用預設的相等比較子 (Comparer) 來非同步判斷查詢是否包含指定的項目。
公用方法 CountAsync() 非同步傳回查詢中的項目數。
公用方法 CountAsync(Func<TElement, Boolean>) 非同步傳回查詢中符合條件的項目數。
公用方法 CountAsync(CancellationToken) 非同步傳回查詢中的項目數。
公用方法 CountAsync(Func<TElement, Boolean>, CancellationToken) 非同步傳回查詢中符合條件的項目數。
公用方法 Equals 判斷目前的查詢是否等於指定的查詢。 (覆寫 Object.Equals(Object)。)
受保護的方法 Finalize (繼承自 Object)。
公用方法 FirstAsync() 非同步傳回查詢的第一個項目。
公用方法 FirstAsync(Func<TElement, Boolean>) 非同步傳回查詢中符合指定條件的第一個項目。
公用方法 FirstAsync(CancellationToken) 非同步傳回查詢的第一個項目。
公用方法 FirstAsync(Func<TElement, Boolean>, CancellationToken) 非同步傳回查詢中符合指定條件的第一個項目。
公用方法 FirstOrDefaultAsync() 非同步傳回查詢的第一個項目，如果查詢結果未包含任何項目，則傳回預設值。
公用方法 FirstOrDefaultAsync(Func<TElement, Boolean>) 非同步傳回查詢中符合指定條件的第一個項目，如果找不到這類項目，則傳回預設值。
公用方法 FirstOrDefaultAsync(CancellationToken) 非同步傳回查詢的第一個項目，如果查詢結果未包含任何項目，則傳回預設值。
公用方法 FirstOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) 非同步傳回查詢中符合指定條件的第一個項目，如果找不到這類項目，則傳回預設值。
公用方法 ForEachAsync(Action<TElement>) 非同步列舉查詢結果，並針對每個項目執行指定動作。
公用方法 ForEachAsync(Action<TElement>, CancellationToken) 非同步列舉查詢結果，並針對每個項目執行指定動作。
公用方法 GetEnumerator 傳回 IEnumerator<T>，其在列舉時會對資料庫執行 SQL 查詢。
公用方法 GetHashCode 傳回此查詢的雜湊函數。 (覆寫 Object.GetHashCode()。)
公用方法 GetType 取得目前查詢的類型。
公用方法 LongCountAsync() 非同步傳回 Int64，表示查詢中的項目總數。
公用方法 LongCountAsync(Func<TElement, Boolean>) 非同步傳回 Int64，表示查詢中符合條件的項目數。
公用方法 LongCountAsync(CancellationToken) 非同步傳回 Int64，表示查詢中的項目總數。
公用方法 LongCountAsync(Func<TElement, Boolean>, CancellationToken) 非同步傳回 Int64，表示查詢中符合條件的項目數。
公用方法 MaxAsync() 非同步傳回查詢的最大值。
公用方法 MaxAsync(CancellationToken) 非同步傳回查詢的最大值。
受保護的方法 MemberwiseClone (繼承自 Object)。
公用方法 MinAsync() 非同步傳回查詢的最小值。
公用方法 MinAsync(CancellationToken) 非同步傳回查詢的最小值。
公用方法 SingleAsync() 非同步傳回查詢的唯一一個項目，如果序列中不是正好一個項目，則擲回例外狀況。
公用方法 SingleAsync(Func<TElement, Boolean>) 非同步傳回查詢中符合指定條件的唯一一個項目，如果有一個以上這類項目，則擲回例外狀況。
公用方法 SingleAsync(CancellationToken) 非同步傳回查詢的唯一一個項目，如果序列中不是正好一個項目，則擲回例外狀況。
公用方法 SingleAsync(Func<TElement, Boolean>, CancellationToken) 非同步傳回查詢中符合指定條件的唯一一個項目，如果有一個以上這類項目，則擲回例外狀況。
公用方法 SingleOrDefaultAsync() 非同步傳回序列的唯一一個項目，如果序列是空白，則為預設值，如果序列中有一個以上的項目，此方法就會擲回例外狀況。
公用方法 SingleOrDefaultAsync(Func<TElement, Boolean>) 非同步傳回查詢中符合指定條件的唯一一個項目，如果沒有這類項目，則為預設值，如果有一個以上的項目符合條件，此方法就會擲回例外狀況。
公用方法 SingleOrDefaultAsync(CancellationToken) 非同步傳回序列的唯一一個項目，如果序列是空白，則為預設值，如果序列中有一個以上的項目，此方法就會擲回例外狀況。
公用方法 SingleOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) 非同步傳回查詢中符合指定條件的唯一一個項目，如果沒有這類項目，則為預設值，如果有一個以上的項目符合條件，此方法就會擲回例外狀況。
公用方法 ToArrayAsync() 透過列舉以非同步方式從查詢建立陣列。
公用方法 ToArrayAsync(CancellationToken) 透過列舉以非同步方式從查詢建立陣列。
公用方法 ToDictionaryAsync<TKey>(Func<TElement, TKey>) 根據指定的索引鍵選取器函式，透過列舉以非同步方式從查詢建立 Dictionary<TKey, TValue>。
公用方法 ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>) 根據指定的索引鍵選取器函數和比較子，透過列舉以非同步方式從查詢建立 Dictionary<TKey, TValue>。
公用方法 ToDictionaryAsync<TKey>(Func<TElement, TKey>, CancellationToken) 根據指定的索引鍵選取器函式，透過列舉以非同步方式從查詢建立 Dictionary<TKey, TValue>。
公用方法 ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>, CancellationToken) 根據指定的索引鍵選取器函數和比較子，透過列舉以非同步方式從查詢建立 Dictionary<TKey, TValue>。
公用方法 ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>) 根據指定的索引鍵選取器以及項目選取器函數，透過列舉以非同步方式從查詢建立 Dictionary<TKey, TValue>。
公用方法 ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>) 根據指定的索引鍵選取器函式、比較子和項目選取器函式，透過列舉以非同步方式從查詢建立 Dictionary<TKey, TValue>。
公用方法 ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, CancellationToken) 根據指定的索引鍵選取器以及項目選取器函數，透過列舉以非同步方式從查詢建立 Dictionary<TKey, TValue>。
公用方法 ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>, CancellationToken) 根據指定的索引鍵選取器函式、比較子和項目選取器函式，透過列舉以非同步方式從查詢建立 Dictionary<TKey, TValue>。
公用方法 ToListAsync() 透過列舉以非同步方式從查詢建立 List<T>。
公用方法 ToListAsync(CancellationToken) 透過列舉以非同步方式從查詢建立 List<T>。
公用方法 ToString 傳回 String，其中包含建立查詢時所設定的 SQL 字串。不包含參數。 (覆寫 Object.ToString()。)

靠上

明確介面實作

  名稱 描述
明確介面實作私用屬性 IListSource.ContainsListCollection 傳回 false。
明確介面實作私用方法 IEnumerable.GetEnumerator 傳回 IEnumerator，其在列舉時會對資料庫執行 SQL 查詢。
明確介面實作私用方法 IListSource.GetList 擲回例外狀況，表示不支援直接繫結至存放區查詢。
明確介面實作私用方法 IDbAsyncEnumerable.GetAsyncEnumerator 傳回 IDbAsyncEnumerable，其在列舉時會對資料庫執行 SQL 查詢。
明確介面實作私用方法 IDbAsyncEnumerable<TElement>.GetAsyncEnumerator 傳回 IDbAsyncEnumerator<T>，其在列舉時會對資料庫執行 SQL 查詢。

靠上

執行緒安全

這個類型的任何 Public static (在 Visual Basic 中為 Shared) 成員都是安全執行緒。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

System.Data.Entity.Infrastructure 命名空間