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

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) Определяет в асинхронном режиме, содержит ли запрос указанный элемент, применяя заданное по умолчанию средство сравнения на равенство.
Открытый метод ContainsAsync(TElement, CancellationToken) Определяет в асинхронном режиме, содержит ли запрос указанный элемент, применяя заданное по умолчанию средство сравнения на равенство.
Открытый метод 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-запрос по отношению к базе данных.

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

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

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

См. также

Справочник

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