Поделиться через

DbSqlQuery<TEntity> - класс

  • Статья

[Эта страница относится к документации к Entity Framework 6. Последняя версия доступна в составе пакета Entity Framework NuGet. Дополнительные сведения об Entity Framework см. в разделе msdn.com/data/ef.]

Представляет SQL-запрос для сущностей, который создан из объекта DbContext и выполняется с использованием соединения из этого контекста. Экземпляры этого класса получены из экземпляра DbSet<TEntity> для типа сущности. Запрос не выполняется при создании этого объекта. Он выполняется при каждом перечислении объекта, например при выполнении инструкции foreach. SQL-запросы к объектам, отличным от сущностей, создаются с использованием SqlQuery<TElement>(String, Object[]). См. DbSqlQuery для ознакомления с неуниверсальной версией этого класса.

Иерархия наследования

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

Пространство имен:  System.Data.Entity.Infrastructure
Сборка:  EntityFramework (в EntityFramework.dll)

Синтаксис

'Декларация
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class DbSqlQuery(Of TEntity As Class) _
    Inherits DbRawSqlQuery(Of TEntity)
'Применение
Dim instance As DbSqlQuery(Of TEntity)

[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbSqlQuery<TEntity> : DbRawSqlQuery<TEntity>
where TEntity : class

[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
generic<typename TEntity>
where TEntity : ref class 
public ref class DbSqlQuery : public DbRawSqlQuery<TEntity>

[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type DbSqlQuery<'TEntity when 'TEntity : not struct> =  
    class 
        inherit DbRawSqlQuery<'TEntity>
    end

JScript does not support generic types and methods.

Параметры типа

  • TEntity
    Тип сущностей, возвращаемых запросом.

Тип DbSqlQuery<TEntity> предоставляет следующие члены.

Конструкторы

  Имя Описание
Защищенный метод DbSqlQuery<TEntity> Создает экземпляр DbSqlQuery<TEntity> при вызове из конструктора производного типа, который будет использоваться как тестовый дубль для SqlQuery(String, array<Object[]).Методы и свойства, используемые в тестовом дубле, должны быть реализованы в нем же за исключением AsNoTracking AsStreaming, которые в стандартной реализации являются операциями no-op.

По верхнему краю

Методы

  Имя Описание
Открытый метод AllAsync(Func<TElement, Boolean>) Определяет в асинхронном режиме, все ли элементы запроса удовлетворяют условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод AllAsync(Func<TElement, Boolean>, CancellationToken) Определяет в асинхронном режиме, все ли элементы запроса удовлетворяют условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод AnyAsync() Определяет в асинхронном режиме, содержит ли запрос какие-либо элементы. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод AnyAsync(Func<TElement, Boolean>) Определяет в асинхронном режиме, удовлетворяет ли какой-либо элемент запроса условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод AnyAsync(CancellationToken) Определяет в асинхронном режиме, содержит ли запрос какие-либо элементы. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод AnyAsync(Func<TElement, Boolean>, CancellationToken) Определяет в асинхронном режиме, удовлетворяет ли какой-либо элемент запроса условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод AsNoTracking Возвращает новый запрос, в котором возвращаемые сущности не кэшируются в DbContext.
Открытый метод AsStreaming Устаревшее. Возвращает новый запрос, который обеспечивает потоковую обработку результатов вместо буферизации.
Открытый метод ContainsAsync(TElement) Определяет в асинхронном режиме, содержит ли запрос указанный элемент, применяя заданное по умолчанию средство сравнения на равенство. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ContainsAsync(TElement, CancellationToken) Определяет в асинхронном режиме, содержит ли запрос указанный элемент, применяя заданное по умолчанию средство сравнения на равенство. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод CountAsync() Возвращает в асинхронном режиме количество элементов в запросе. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод CountAsync(Func<TElement, Boolean>) Возвращает в асинхронном режиме количество элементов в запросе, удовлетворяющих условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод CountAsync(CancellationToken) Возвращает в асинхронном режиме количество элементов в запросе. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод CountAsync(Func<TElement, Boolean>, CancellationToken) Возвращает в асинхронном режиме количество элементов в запросе, удовлетворяющих условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод Equals Указывает, равен ли данный экземпляр конкретному объекту. (Переопределяет DbRawSqlQuery<TElement>.Equals(Object).)
Защищенный метод Finalize (Унаследовано от Object.)
Открытый метод FirstAsync() Возвращает в асинхронном режиме первый элемент запроса. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод FirstAsync(Func<TElement, Boolean>) Возвращает в асинхронном режиме первый элемент запроса, удовлетворяющий указанному условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод FirstAsync(CancellationToken) Возвращает в асинхронном режиме первый элемент запроса. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод FirstAsync(Func<TElement, Boolean>, CancellationToken) Возвращает в асинхронном режиме первый элемент запроса, удовлетворяющий указанному условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод FirstOrDefaultAsync() Возвращает в асинхронном режиме первый элемент запроса или значение по умолчанию, если результат запроса не содержит элементов. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод FirstOrDefaultAsync(Func<TElement, Boolean>) Возвращает в асинхронном режиме первый элемент запроса, удовлетворяющий указанному условию, или значение по умолчанию, если таковой элемент не найден. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод FirstOrDefaultAsync(CancellationToken) Возвращает в асинхронном режиме первый элемент запроса или значение по умолчанию, если результат запроса не содержит элементов. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод FirstOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) Возвращает в асинхронном режиме первый элемент запроса, удовлетворяющий указанному условию, или значение по умолчанию, если таковой элемент не найден. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ForEachAsync(Action<TElement>) Перечисляет в асинхронном режиме результаты запроса и выполняет указанное действие над каждым элементом. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ForEachAsync(Action<TElement>, CancellationToken) Перечисляет в асинхронном режиме результаты запроса и выполняет указанное действие над каждым элементом. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод GetEnumerator Возвращает объект IEnumerator<T>, который при перечислении выполняет заданный SQL-запрос по отношению к базе данных. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод GetHashCode Получает хэш-код, связанный с этим экземпляром. (Переопределяет DbRawSqlQuery<TElement>.GetHashCode().)
Открытый метод GetType Получает тип, связанный с этим экземпляром.
Открытый метод LongCountAsync() Возвращает в асинхронном режиме значение Int64, которое представляет общее количество элементов в запросе. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод LongCountAsync(Func<TElement, Boolean>) Возвращает в асинхронном режиме значение Int64, которое представляет количество элементов в запросе, удовлетворяющих условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод LongCountAsync(CancellationToken) Возвращает в асинхронном режиме значение Int64, которое представляет общее количество элементов в запросе. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод LongCountAsync(Func<TElement, Boolean>, CancellationToken) Возвращает в асинхронном режиме значение Int64, которое представляет количество элементов в запросе, удовлетворяющих условию. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод MaxAsync() Возвращает в асинхронном режиме максимальное значение запроса. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод MaxAsync(CancellationToken) Возвращает в асинхронном режиме максимальное значение запроса. (Унаследовано от DbRawSqlQuery<TElement>.)
Защищенный метод MemberwiseClone (Унаследовано от Object.)
Открытый метод MinAsync() Возвращает в асинхронном режиме минимальное значение запроса. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод MinAsync(CancellationToken) Возвращает в асинхронном режиме минимальное значение запроса. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод SingleAsync() Возвращает в асинхронном режиме единственный элемент запроса и вызывает исключение, если количество элементов в последовательности не равно точно одному. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод SingleAsync(Func<TElement, Boolean>) Возвращает в асинхронном режиме единственный элемент запроса, удовлетворяющий заданному условию, и вызывает исключение, если существуют несколько таких элементов. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод SingleAsync(CancellationToken) Возвращает в асинхронном режиме единственный элемент запроса и вызывает исключение, если количество элементов в последовательности не равно точно одному. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод SingleAsync(Func<TElement, Boolean>, CancellationToken) Возвращает в асинхронном режиме единственный элемент запроса, удовлетворяющий заданному условию, и вызывает исключение, если существуют несколько таких элементов. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод SingleOrDefaultAsync() Возвращает в асинхронном режиме единственный элемент последовательности или значение по умолчанию, если последовательность пуста; этот метод вызывает исключение, если количество элементов в последовательности больше одного. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод SingleOrDefaultAsync(Func<TElement, Boolean>) Возвращает в асинхронном режиме единственный элемент запроса, удовлетворяющий заданному условию, или значение по умолчанию, если таковой элемент не существует; этот метод вызывает исключение, если условию удовлетворяют больше одного элемента. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод SingleOrDefaultAsync(CancellationToken) Возвращает в асинхронном режиме единственный элемент последовательности или значение по умолчанию, если последовательность пуста; этот метод вызывает исключение, если количество элементов в последовательности больше одного. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод SingleOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) Возвращает в асинхронном режиме единственный элемент запроса, удовлетворяющий заданному условию, или значение по умолчанию, если таковой элемент не существует; этот метод вызывает исключение, если условию удовлетворяют больше одного элемента. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ToArrayAsync() Создает массив из запроса путем перечисления его в асинхронном режиме. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ToArrayAsync(CancellationToken) Создает массив из запроса путем перечисления его в асинхронном режиме. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ToDictionaryAsync<TKey>(Func<TElement, TKey>) Создает выражение Dictionary<TKey, TValue> из запроса путем его перечисления в асинхронном режиме согласно заданной функции выбора ключа. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>) Создает выражение 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, TResult>(Func<TElement, TKey>, Func<TElement, TResult>) Создает выражение 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>, CancellationToken) Создает выражение Dictionary<TKey, TValue> из запроса путем его перечисления в асинхронном режиме согласно заданной функции выбора ключа и выбора элемента. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>, CancellationToken) Создает выражение Dictionary<TKey, TValue> из запроса путем его перечисления в асинхронном режиме согласно заданной функции выбора ключа, средства сравнения и функции выбора элемента. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ToListAsync() Создает выражение List<T> из запроса путем его перечисления в асинхронном режиме. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ToListAsync(CancellationToken) Создает выражение List<T> из запроса путем его перечисления в асинхронном режиме. (Унаследовано от DbRawSqlQuery<TElement>.)
Открытый метод ToString Возвращает строковое представление этого экземпляра. (Переопределяет DbRawSqlQuery<TElement>.ToString().)

По верхнему краю

Явные реализации интерфейса

  Имя Описание
Явная реализация интерфейсаЗакрытое свойство IListSource.ContainsListCollection Возвращает значение типа false. (Унаследовано от DbRawSqlQuery<TElement>.)
Явная реализация интерфейсаЗакрытый метод IEnumerable.GetEnumerator Возвращает объект IEnumerator, который при перечислении выполняет заданный SQL-запрос по отношению к базе данных. (Унаследовано от DbRawSqlQuery<TElement>.)
Явная реализация интерфейсаЗакрытый метод IListSource.GetList Вызывает исключение, указывающее, что прямая привязка к запросу к хранилищу не поддерживается. (Унаследовано от DbRawSqlQuery<TElement>.)
Явная реализация интерфейсаЗакрытый метод IDbAsyncEnumerable.GetAsyncEnumerator Возвращает объект IDbAsyncEnumerable, который при перечислении выполняет заданный SQL-запрос по отношению к базе данных. (Унаследовано от DbRawSqlQuery<TElement>.)
Явная реализация интерфейсаЗакрытый метод IDbAsyncEnumerable<TElement>.GetAsyncEnumerator Возвращает объект IDbAsyncEnumerator<T>, который при перечислении выполняет заданный SQL-запрос по отношению к базе данных. (Унаследовано от DbRawSqlQuery<TElement>.)

По верхнему краю

Потокобезопасность

Любые открытые члены этого типа, объявленные как static (Shared в Visual Basic), являются потокобезопасными. Потокобезопасная работа с членами экземпляров типа не гарантируется.

См. также

Справочник

System.Data.Entity.Infrastructure - пространство имен