Compartilhar via


DbSqlQuery<TEntity> Classe

Definição

Representa uma consulta SQL para entidades criadas a partir de um DbContext e é executada usando a conexão desse contexto. As instâncias dessa classe são obtidas da DbSet<TEntity> instância para o tipo de entidade. A consulta não é executada quando esse objeto é criado; ele é executado sempre que é enumerado, por exemplo, usando foreach. Consultas SQL para não entidades são criadas usando SqlQuery<TElement>(String, Object[]). Consulte DbSqlQuery para obter uma versão não genérica dessa classe.

[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)

Parâmetros de tipo

TEntity

O tipo de entidades retornadas pela consulta.

Herança
DbRawSqlQuery<TEntity>
DbSqlQuery<TEntity>
Herança
DbSqlQuery<TEntity>
Atributos

Construtores

DbSqlQuery<TEntity>()

Cria uma instância de um DbSqlQuery<TEntity> quando chamado do construtor de um tipo derivado que será usado como um double de teste para SqlQuery(String, Object[]). Métodos e propriedades que serão usados pelo duplo teste devem ser implementados pelo duplo teste, exceto AsNoTracking e AsStreaming, em que a implementação padrão é uma no-op.

Métodos

AllAsync(Func<TElement,Boolean>)

Determina de forma assíncrona se todos os elementos da consulta atendem a uma condição.

(Herdado de DbRawSqlQuery<TElement>)
AllAsync(Func<TElement,Boolean>, CancellationToken)

Determina de forma assíncrona se todos os elementos da consulta atendem a uma condição.

(Herdado de DbRawSqlQuery<TElement>)
AnyAsync()

Determina de forma assíncrona se a consulta contém elementos.

(Herdado de DbRawSqlQuery<TElement>)
AnyAsync(CancellationToken)

Determina de forma assíncrona se a consulta contém elementos.

(Herdado de DbRawSqlQuery<TElement>)
AnyAsync(Func<TElement,Boolean>)

Determina de forma assíncrona se algum elemento da consulta atende a uma condição.

(Herdado de DbRawSqlQuery<TElement>)
AnyAsync(Func<TElement,Boolean>, CancellationToken)

Determina de forma assíncrona se algum elemento da consulta atende a uma condição.

(Herdado de DbRawSqlQuery<TElement>)
AsNoTracking()

Retorna uma nova consulta em que as entidades retornadas não serão armazenadas em cache no DbContext.

AsStreaming()
Obsoleto.

Retorna uma nova consulta que transmitirá os resultados em vez de buffer.

AsStreaming()
Obsoleto.

Retorna uma nova consulta que transmitirá os resultados em vez de buffer.

(Herdado de DbRawSqlQuery<TElement>)
ContainsAsync(TElement)

Determina de forma assíncrona se a consulta contém um elemento especificado usando o comparador de igualdade padrão.

(Herdado de DbRawSqlQuery<TElement>)
ContainsAsync(TElement, CancellationToken)

Determina de forma assíncrona se a consulta contém um elemento especificado usando o comparador de igualdade padrão.

(Herdado de DbRawSqlQuery<TElement>)
CountAsync()

Retorna de forma assíncrona o número de elementos na consulta.

(Herdado de DbRawSqlQuery<TElement>)
CountAsync(CancellationToken)

Retorna de forma assíncrona o número de elementos na consulta.

(Herdado de DbRawSqlQuery<TElement>)
CountAsync(Func<TElement,Boolean>)

Retorna de forma assíncrona o número de elementos na consulta que atendem a uma condição.

(Herdado de DbRawSqlQuery<TElement>)
CountAsync(Func<TElement,Boolean>, CancellationToken)

Retorna de forma assíncrona o número de elementos na consulta que atendem a uma condição.

(Herdado de DbRawSqlQuery<TElement>)
Equals(Object)

Representa uma consulta SQL para entidades criadas a partir de um DbContext e é executada usando a conexão desse contexto. As instâncias dessa classe são obtidas da DbSet<TEntity> instância para o tipo de entidade. A consulta não é executada quando esse objeto é criado; ele é executado sempre que é enumerado, por exemplo, usando foreach. Consultas SQL para não entidades são criadas usando SqlQuery<TElement>(String, Object[]). Consulte DbSqlQuery para obter uma versão não genérica dessa classe.

FirstAsync()

Retorna de forma assíncrona o primeiro elemento da consulta.

(Herdado de DbRawSqlQuery<TElement>)
FirstAsync(CancellationToken)

Retorna de forma assíncrona o primeiro elemento da consulta.

(Herdado de DbRawSqlQuery<TElement>)
FirstAsync(Func<TElement,Boolean>)

Retorna de forma assíncrona o primeiro elemento da consulta que atende a uma condição especificada.

(Herdado de DbRawSqlQuery<TElement>)
FirstAsync(Func<TElement,Boolean>, CancellationToken)

Retorna de forma assíncrona o primeiro elemento da consulta que atende a uma condição especificada.

(Herdado de DbRawSqlQuery<TElement>)
FirstOrDefaultAsync()

Retorna de forma assíncrona o primeiro elemento da consulta ou um valor padrão se o resultado da consulta não contiver elementos.

(Herdado de DbRawSqlQuery<TElement>)
FirstOrDefaultAsync(CancellationToken)

Retorna de forma assíncrona o primeiro elemento da consulta ou um valor padrão se o resultado da consulta não contiver elementos.

(Herdado de DbRawSqlQuery<TElement>)
FirstOrDefaultAsync(Func<TElement,Boolean>)

Retorna de forma assíncrona o primeiro elemento da consulta que atende a uma condição especificada ou um valor padrão se nenhum elemento desse tipo for encontrado.

(Herdado de DbRawSqlQuery<TElement>)
FirstOrDefaultAsync(Func<TElement,Boolean>, CancellationToken)

Retorna de forma assíncrona o primeiro elemento da consulta que atende a uma condição especificada ou um valor padrão se nenhum elemento desse tipo for encontrado.

(Herdado de DbRawSqlQuery<TElement>)
ForEachAsync(Action<TElement>)

Enumera de forma assíncrona os resultados da consulta e executa a ação especificada em cada elemento.

(Herdado de DbRawSqlQuery<TElement>)
ForEachAsync(Action<TElement>, CancellationToken)

Enumera de forma assíncrona os resultados da consulta e executa a ação especificada em cada elemento.

(Herdado de DbRawSqlQuery<TElement>)
GetEnumerator()

Executa a consulta e retorna um enumerador para os elementos.

GetEnumerator()

Retorna um IEnumerator<T> que, quando enumerado, executará a consulta SQL no banco de dados.

(Herdado de DbRawSqlQuery<TElement>)
GetHashCode()

Representa uma consulta SQL para entidades criadas a partir de um DbContext e é executada usando a conexão desse contexto. As instâncias dessa classe são obtidas da DbSet<TEntity> instância para o tipo de entidade. A consulta não é executada quando esse objeto é criado; ele é executado sempre que é enumerado, por exemplo, usando foreach. Consultas SQL para não entidades são criadas usando SqlQuery<TElement>(String, Object[]). Consulte DbSqlQuery para obter uma versão não genérica dessa classe.

GetType()

Representa uma consulta SQL para entidades criadas a partir de um DbContext e é executada usando a conexão desse contexto. As instâncias dessa classe são obtidas da DbSet<TEntity> instância para o tipo de entidade. A consulta não é executada quando esse objeto é criado; ele é executado sempre que é enumerado, por exemplo, usando foreach. Consultas SQL para não entidades são criadas usando SqlQuery<TElement>(String, Object[]). Consulte DbSqlQuery para obter uma versão não genérica dessa classe.

LongCountAsync()

Retorna de forma assíncrona um Int64 que representa o número total de elementos na consulta.

(Herdado de DbRawSqlQuery<TElement>)
LongCountAsync(CancellationToken)

Retorna de forma assíncrona um Int64 que representa o número total de elementos na consulta.

(Herdado de DbRawSqlQuery<TElement>)
LongCountAsync(Func<TElement,Boolean>)

Retorna de forma assíncrona um Int64 que representa o número de elementos na consulta que atendem a uma condição.

(Herdado de DbRawSqlQuery<TElement>)
LongCountAsync(Func<TElement,Boolean>, CancellationToken)

Retorna de forma assíncrona um Int64 que representa o número de elementos na consulta que atendem a uma condição.

(Herdado de DbRawSqlQuery<TElement>)
MaxAsync()

Retorna de forma assíncrona o valor máximo da consulta.

(Herdado de DbRawSqlQuery<TElement>)
MaxAsync(CancellationToken)

Retorna de forma assíncrona o valor máximo da consulta.

(Herdado de DbRawSqlQuery<TElement>)
MinAsync()

Retorna de forma assíncrona o valor mínimo da consulta.

(Herdado de DbRawSqlQuery<TElement>)
MinAsync(CancellationToken)

Retorna de forma assíncrona o valor mínimo da consulta.

(Herdado de DbRawSqlQuery<TElement>)
SingleAsync()

Retorna de forma assíncrona o único elemento da consulta e gera uma exceção se não houver exatamente um elemento na sequência.

(Herdado de DbRawSqlQuery<TElement>)
SingleAsync(CancellationToken)

Retorna de forma assíncrona o único elemento da consulta e gera uma exceção se não houver exatamente um elemento na sequência.

(Herdado de DbRawSqlQuery<TElement>)
SingleAsync(Func<TElement,Boolean>)

Retorna de forma assíncrona o único elemento da consulta que atende a uma condição especificada e gera uma exceção se houver mais de um desses elementos.

(Herdado de DbRawSqlQuery<TElement>)
SingleAsync(Func<TElement,Boolean>, CancellationToken)

Retorna de forma assíncrona o único elemento da consulta que atende a uma condição especificada e gera uma exceção se houver mais de um desses elementos.

(Herdado de DbRawSqlQuery<TElement>)
SingleOrDefaultAsync()

Retorna de forma assíncrona o único elemento de uma sequência ou um valor padrão se a sequência estiver vazia; esse método gerará uma exceção se houver mais de um elemento na sequência.

(Herdado de DbRawSqlQuery<TElement>)
SingleOrDefaultAsync(CancellationToken)

Retorna de forma assíncrona o único elemento de uma sequência ou um valor padrão se a sequência estiver vazia; esse método gerará uma exceção se houver mais de um elemento na sequência.

(Herdado de DbRawSqlQuery<TElement>)
SingleOrDefaultAsync(Func<TElement,Boolean>)

Retorna de forma assíncrona o único elemento da consulta que atende a uma condição especificada ou um valor padrão se esse elemento não existir; esse método gerará uma exceção se mais de um elemento atender à condição.

(Herdado de DbRawSqlQuery<TElement>)
SingleOrDefaultAsync(Func<TElement,Boolean>, CancellationToken)

Retorna de forma assíncrona o único elemento da consulta que atende a uma condição especificada ou um valor padrão se esse elemento não existir; esse método gerará uma exceção se mais de um elemento atender à condição.

(Herdado de DbRawSqlQuery<TElement>)
ToArrayAsync()

Cria uma matriz da consulta enumerando-a de forma assíncrona.

(Herdado de DbRawSqlQuery<TElement>)
ToArrayAsync(CancellationToken)

Cria uma matriz da consulta enumerando-a de forma assíncrona.

(Herdado de DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey,TResult>(Func<TElement,TKey>, Func<TElement,TResult>)

Cria um Dictionary<TKey,TValue> da consulta enumerando-o de forma assíncrona de acordo com um seletor de chave especificado e uma função seletora de elemento.

(Herdado de DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey,TResult>(Func<TElement,TKey>, Func<TElement,TResult>, CancellationToken)

Cria um Dictionary<TKey,TValue> da consulta enumerando-o de forma assíncrona de acordo com um seletor de chave especificado e uma função seletora de elemento.

(Herdado de DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey,TResult>(Func<TElement,TKey>, Func<TElement,TResult>, IEqualityComparer<TKey>)

Cria um Dictionary<TKey,TValue> da consulta enumerando-o de forma assíncrona de acordo com uma função de seletor de chave especificada, um comparador e uma função seletora de elemento.

(Herdado de DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey,TResult>(Func<TElement,TKey>, Func<TElement,TResult>, IEqualityComparer<TKey>, CancellationToken)

Cria um Dictionary<TKey,TValue> da consulta enumerando-o de forma assíncrona de acordo com uma função de seletor de chave especificada, um comparador e uma função seletora de elemento.

(Herdado de DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey>(Func<TElement,TKey>)

Cria um Dictionary<TKey,TValue> da consulta enumerando-o de forma assíncrona de acordo com uma função de seletor de chave especificada.

(Herdado de DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey>(Func<TElement,TKey>, CancellationToken)

Cria um Dictionary<TKey,TValue> da consulta enumerando-o de forma assíncrona de acordo com uma função de seletor de chave especificada.

(Herdado de DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey>(Func<TElement,TKey>, IEqualityComparer<TKey>)

Cria um Dictionary<TKey,TValue> da consulta enumerando-o de forma assíncrona de acordo com uma função de seletor de chave especificada e um comparador.

(Herdado de DbRawSqlQuery<TElement>)
ToDictionaryAsync<TKey>(Func<TElement,TKey>, IEqualityComparer<TKey>, CancellationToken)

Cria um Dictionary<TKey,TValue> da consulta enumerando-o de forma assíncrona de acordo com uma função de seletor de chave especificada e um comparador.

(Herdado de DbRawSqlQuery<TElement>)
ToListAsync()

Cria um List<T> da consulta enumerando-o de forma assíncrona.

(Herdado de DbRawSqlQuery<TElement>)
ToListAsync(CancellationToken)

Cria um List<T> da consulta enumerando-o de forma assíncrona.

(Herdado de DbRawSqlQuery<TElement>)
ToString()

Retorna um String que contém a cadeia de caracteres SQL que foi definida quando a consulta foi criada. Os parâmetros não estão incluídos.

Implantações explícitas de interface

IDbAsyncEnumerable.GetAsyncEnumerator()

Retorna um IDbAsyncEnumerable que, quando enumerado, executará a consulta SQL no banco de dados.

(Herdado de DbRawSqlQuery<TElement>)
IDbAsyncEnumerable<TElement>.GetAsyncEnumerator()

Retorna um IDbAsyncEnumerable<T> que, quando enumerado, executará a consulta SQL no banco de dados.

(Herdado de DbRawSqlQuery<TElement>)
IEnumerable.GetEnumerator()

Executa a consulta e retorna um enumerador para os elementos.

IEnumerable.GetEnumerator()

Retorna um IEnumerator que, quando enumerado, executará a consulta SQL no banco de dados.

(Herdado de DbRawSqlQuery<TElement>)
IListSource.ContainsListCollection

Retorna false.

IListSource.ContainsListCollection

Retorna false.

(Herdado de DbRawSqlQuery<TElement>)
IListSource.GetList()

Gera uma exceção indicando que não há suporte para associação diretamente a uma consulta de repositório.

IListSource.GetList()

Gera uma exceção indicando que não há suporte para associação diretamente a uma consulta de repositório.

(Herdado de DbRawSqlQuery<TElement>)

Aplica-se a