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

DbSqlQuery - класс

  • Статья

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

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

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

System.Object
  System.Data.Entity.Infrastructure.DbRawSqlQuery
    System.Data.Entity.Infrastructure.DbSqlQuery

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

Синтаксис

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

[SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")]
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
public class DbSqlQuery : DbRawSqlQuery

[SuppressMessageAttribute(L"Microsoft.Design", L"CA1010:CollectionsShouldImplementGenericInterface")]
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
public ref class DbSqlQuery : public DbRawSqlQuery

[<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")>]
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
type DbSqlQuery =  
    class 
        inherit DbRawSqlQuery 
    end

public class DbSqlQuery extends DbRawSqlQuery

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

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

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

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

Методы

  Имя Описание
Открытый метод AsNoTracking Возвращает новый запрос, в котором результаты запроса не отслеживаются связанным объектом DbContext.
Открытый метод AsStreaming Устаревшее. Возвращает новый запрос, который обеспечивает потоковую обработку результатов вместо буферизации.
Открытый метод Equals Определяет, равен ли заданный объект текущему элементу. (Переопределяет DbRawSqlQuery.Equals(Object).)
Защищенный метод Finalize (Унаследовано от Object.)
Открытый метод ForEachAsync(Action<Object>) Перечисляет в асинхронном режиме результаты запроса и выполняет указанное действие над каждым элементом. (Унаследовано от DbRawSqlQuery.)
Открытый метод ForEachAsync(Action<Object>, CancellationToken) Перечисляет в асинхронном режиме результаты запроса и выполняет указанное действие над каждым элементом. (Унаследовано от DbRawSqlQuery.)
Открытый метод GetEnumerator Возвращает объект IEnumerator, который при перечислении выполняет заданный SQL-запрос по отношению к базе данных. (Унаследовано от DbRawSqlQuery.)
Открытый метод GetHashCode Возвращает хэш-код текущего экземпляра. (Переопределяет DbRawSqlQuery.GetHashCode().)
Открытый метод GetType Возвращает тип, связанный с запросом.
Защищенный метод MemberwiseClone (Унаследовано от Object.)
Открытый метод ToListAsync() Создает выражение List<T> из запроса путем его перечисления в асинхронном режиме. (Унаследовано от DbRawSqlQuery.)
Открытый метод ToListAsync(CancellationToken) Создает выражение List<T> из запроса путем его перечисления в асинхронном режиме. (Унаследовано от DbRawSqlQuery.)
Открытый метод ToString Возвращает представление String, которое содержит строку SQL, заданную при создании запроса.Параметры не включены. (Переопределяет DbRawSqlQuery.ToString().)

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

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

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

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

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

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

См. также

Справочник

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