Compartir a través de

DbSqlQuery<TEntity> (Clase)

  • Artículo

[Esta página es específica de la versión 6 de Entity Framework. La versión más reciente está disponible como el paquete NuGet de Entity Framework. Para más información sobre Entity Framework, consulte msdn.com/es-ES/data/ef].

Representa una consulta SQL para entidades que se crean a partir de un objeto DbContext y se ejecuta utilizando la conexión desde ese contexto. Las instancias de esta clase se obtienen de la instancia de DbSet<TEntity> para el tipo de entidad. La consulta no se ejecuta cuando se crea este objeto; se ejecuta cada vez que se enumera, por ejemplo, utilizando foreach. Las consultas SQL para elementos que no son entidades se crean mediante SqlQuery<TElement>(String, Object[]). Vea DbSqlQuery en el caso de una versión no genérica de esta clase.

Jerarquía de herencia

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

Espacio de nombres:  System.Data.Entity.Infrastructure
Ensamblado:  EntityFramework (en EntityFramework.dll)

Sintaxis

'Declaración
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
Public Class DbSqlQuery(Of TEntity As Class) _
    Inherits DbRawSqlQuery(Of TEntity)
'Uso
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.

Parámetros de tipo

  • TEntity
    Tipo de las entidades devueltas por la consulta.

El tipo DbSqlQuery<TEntity> expone los siguientes miembros.

Constructores

  Name Descripción
Método protegido DbSqlQuery<TEntity> Crea una instancia de un DbSqlQuery<TEntity> al ser invocado desde el constructor de un tipo derivado que se utilizará como prueba de doble para SqlQuery(String, array<Object[]).Los métodos y las propiedades que va a usar la prueba de doble deben implementarse en la prueba de doble, salvo AsNoTracking y AsStreaming, donde la implementación predeterminada es una operación sin efecto.

Superior

Métodos

  Name Descripción
Método público AllAsync(Func<TElement, Boolean>) Determina de forma asincrónica si todos los elementos de la consulta cumplen una condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público AllAsync(Func<TElement, Boolean>, CancellationToken) Determina de forma asincrónica si todos los elementos de la consulta cumplen una condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público AnyAsync() Determina de forma asincrónica si la consulta contiene algún elemento. (Se hereda de DbRawSqlQuery<TElement>).
Método público AnyAsync(Func<TElement, Boolean>) Determina de forma asincrónica si algún elemento de la consulta cumple una condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público AnyAsync(CancellationToken) Determina de forma asincrónica si la consulta contiene algún elemento. (Se hereda de DbRawSqlQuery<TElement>).
Método público AnyAsync(Func<TElement, Boolean>, CancellationToken) Determina de forma asincrónica si algún elemento de la consulta cumple una condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público AsNoTracking Devuelve una nueva consulta donde las entidades devueltas no se almacenarán en memoria caché en el DbContext.
Método público AsStreaming Obsoleta. Devuelve una consulta que transmitirá por secuencias los resultados en lugar de almacenarlos en búfer.
Método público ContainsAsync(TElement) Determina de forma asincrónica si la consulta contiene un elemento especificado mediante el comparador de igualdad predeterminado. (Se hereda de DbRawSqlQuery<TElement>).
Método público ContainsAsync(TElement, CancellationToken) Determina de forma asincrónica si la consulta contiene un elemento especificado mediante el comparador de igualdad predeterminado. (Se hereda de DbRawSqlQuery<TElement>).
Método público CountAsync() Devuelve de forma asincrónica el número de elementos de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público CountAsync(Func<TElement, Boolean>) Devuelve de forma asincrónica el número de elementos de la consulta que cumplen una condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público CountAsync(CancellationToken) Devuelve de forma asincrónica el número de elementos de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público CountAsync(Func<TElement, Boolean>, CancellationToken) Devuelve de forma asincrónica el número de elementos de la consulta que cumplen una condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público Equals Indica si esta instancia es equivalente a un objeto especificado. (Invalida a DbRawSqlQuery<TElement>.Equals(Object)).
Método protegido Finalize (Se hereda de Object).
Método público FirstAsync() Devuelve de forma asincrónica el primer elemento de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público FirstAsync(Func<TElement, Boolean>) Devuelve de forma asincrónica el primer elemento de la consulta que cumple una condición especificada. (Se hereda de DbRawSqlQuery<TElement>).
Método público FirstAsync(CancellationToken) Devuelve de forma asincrónica el primer elemento de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público FirstAsync(Func<TElement, Boolean>, CancellationToken) Devuelve de forma asincrónica el primer elemento de la consulta que cumple una condición especificada. (Se hereda de DbRawSqlQuery<TElement>).
Método público FirstOrDefaultAsync() Devuelve de forma asincrónica el primer elemento de la consulta, o un valor predeterminado si el resultado de la consulta no contiene ningún elemento. (Se hereda de DbRawSqlQuery<TElement>).
Método público FirstOrDefaultAsync(Func<TElement, Boolean>) Devuelve de forma asincrónica el primer elemento de la consulta que cumple una condición especificada o un valor predeterminado si no se encuentra ningún elemento. (Se hereda de DbRawSqlQuery<TElement>).
Método público FirstOrDefaultAsync(CancellationToken) Devuelve de forma asincrónica el primer elemento de la consulta, o un valor predeterminado si el resultado de la consulta no contiene ningún elemento. (Se hereda de DbRawSqlQuery<TElement>).
Método público FirstOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) Devuelve de forma asincrónica el primer elemento de la consulta que cumple una condición especificada o un valor predeterminado si no se encuentra ningún elemento. (Se hereda de DbRawSqlQuery<TElement>).
Método público ForEachAsync(Action<TElement>) Enumera de forma asincrónica los resultados de la consulta y realiza la acción especificada en cada elemento. (Se hereda de DbRawSqlQuery<TElement>).
Método público ForEachAsync(Action<TElement>, CancellationToken) Enumera de forma asincrónica los resultados de la consulta y realiza la acción especificada en cada elemento. (Se hereda de DbRawSqlQuery<TElement>).
Método público GetEnumerator Devuelve una IEnumerator<T> que, cuando se enumera, ejecutará la consulta SQL en la base de datos. (Se hereda de DbRawSqlQuery<TElement>).
Método público GetHashCode Obtiene el código hash asociado a esta instancia. (Invalida a DbRawSqlQuery<TElement>.GetHashCode()).
Método público GetType Obtiene el tipo asociado a esta instancia.
Método público LongCountAsync() Devuelve de forma asincrónica un valor Int64 que representa el número total de elementos de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público LongCountAsync(Func<TElement, Boolean>) Devuelve de forma asincrónica un valor Int64 que representa el número de elementos de la consulta que cumplen una condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público LongCountAsync(CancellationToken) Devuelve de forma asincrónica un valor Int64 que representa el número total de elementos de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público LongCountAsync(Func<TElement, Boolean>, CancellationToken) Devuelve de forma asincrónica un valor Int64 que representa el número de elementos de la consulta que cumplen una condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público MaxAsync() Devuelve de forma asincrónica el valor máximo de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público MaxAsync(CancellationToken) Devuelve de forma asincrónica el valor máximo de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método protegido MemberwiseClone (Se hereda de Object).
Método público MinAsync() Devuelve de forma asincrónica el valor mínimo de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público MinAsync(CancellationToken) Devuelve de forma asincrónica el valor mínimo de la consulta. (Se hereda de DbRawSqlQuery<TElement>).
Método público SingleAsync() Devuelve de forma asincrónica el único elemento de la consulta y, si no hay exactamente un elemento en la secuencia, produce una excepción. (Se hereda de DbRawSqlQuery<TElement>).
Método público SingleAsync(Func<TElement, Boolean>) Devuelve de forma asincrónica el único elemento de la consulta que cumple una condición especificada y, si existe más de un elemento semejante, produce una excepción. (Se hereda de DbRawSqlQuery<TElement>).
Método público SingleAsync(CancellationToken) Devuelve de forma asincrónica el único elemento de la consulta y, si no hay exactamente un elemento en la secuencia, produce una excepción. (Se hereda de DbRawSqlQuery<TElement>).
Método público SingleAsync(Func<TElement, Boolean>, CancellationToken) Devuelve de forma asincrónica el único elemento de la consulta que cumple una condición especificada y, si existe más de un elemento semejante, produce una excepción. (Se hereda de DbRawSqlQuery<TElement>).
Método público SingleOrDefaultAsync() Devuelve de forma asincrónica el único elemento de una secuencia o un valor predeterminado si la secuencia está vacía; este método produce una excepción si hay más de un elemento en la secuencia. (Se hereda de DbRawSqlQuery<TElement>).
Método público SingleOrDefaultAsync(Func<TElement, Boolean>) Devuelve de forma asincrónica el único elemento de la consulta que cumple una condición especificada o un valor predeterminado si ese elemento no existe; este método produce una excepción si varios elementos cumplen la condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público SingleOrDefaultAsync(CancellationToken) Devuelve de forma asincrónica el único elemento de una secuencia o un valor predeterminado si la secuencia está vacía; este método produce una excepción si hay más de un elemento en la secuencia. (Se hereda de DbRawSqlQuery<TElement>).
Método público SingleOrDefaultAsync(Func<TElement, Boolean>, CancellationToken) Devuelve de forma asincrónica el único elemento de la consulta que cumple una condición especificada o un valor predeterminado si ese elemento no existe; este método produce una excepción si varios elementos cumplen la condición. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToArrayAsync() Crea una matriz a partir de la consulta enumerándola de forma asincrónica. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToArrayAsync(CancellationToken) Crea una matriz a partir de la consulta enumerándola de forma asincrónica. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToDictionaryAsync<TKey>(Func<TElement, TKey>) Crea un Dictionary<TKey, TValue> a partir de la consulta enumerándola de forma asincrónica de acuerdo con una función de selector de clave especificada. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>) Crea un Dictionary<TKey, TValue> a partir de la consulta enumerándola de forma asincrónica de acuerdo con una función de selector de clave especificada y un comparador. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToDictionaryAsync<TKey>(Func<TElement, TKey>, CancellationToken) Crea un Dictionary<TKey, TValue> a partir de la consulta enumerándola de forma asincrónica de acuerdo con una función de selector de clave especificada. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToDictionaryAsync<TKey>(Func<TElement, TKey>, IEqualityComparer<TKey>, CancellationToken) Crea un Dictionary<TKey, TValue> a partir de la consulta enumerándola de forma asincrónica de acuerdo con una función de selector de clave especificada y un comparador. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>) Crea un Dictionary<TKey, TValue> a partir de la consulta enumerándola de forma asincrónica de acuerdo con una función de selector de clave y una función de selector de elemento especificadas. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>) Crea un Dictionary<TKey, TValue> a partir de la consulta enumerándola de forma asincrónica de acuerdo con una función de selector de clave, un comparador y una función de selector de elemento especificados. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, CancellationToken) Crea un Dictionary<TKey, TValue> a partir de la consulta enumerándola de forma asincrónica de acuerdo con una función de selector de clave y una función de selector de elemento especificadas. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToDictionaryAsync<TKey, TResult>(Func<TElement, TKey>, Func<TElement, TResult>, IEqualityComparer<TKey>, CancellationToken) Crea un Dictionary<TKey, TValue> a partir de la consulta enumerándola de forma asincrónica de acuerdo con una función de selector de clave, un comparador y una función de selector de elemento especificados. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToListAsync() Crea una List<T> a partir de la consulta enumerándola de forma asincrónica. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToListAsync(CancellationToken) Crea una List<T> a partir de la consulta enumerándola de forma asincrónica. (Se hereda de DbRawSqlQuery<TElement>).
Método público ToString Devuelve una representación en forma de cadena de esta instancia. (Invalida a DbRawSqlQuery<TElement>.ToString()).

Superior

Implementaciones de interfaz explícita

  Name Descripción
Implementación explícita de interfacesPropiedad privada IListSource.ContainsListCollection Devuelve false. (Se hereda de DbRawSqlQuery<TElement>).
Implementación explícita de interfacesMétodo privado IEnumerable.GetEnumerator Devuelve una IEnumerator que, cuando se enumera, ejecutará la consulta SQL en la base de datos. (Se hereda de DbRawSqlQuery<TElement>).
Implementación explícita de interfacesMétodo privado IListSource.GetList Produce una excepción que indica que no se admite el enlace directo a una consulta de almacén. (Se hereda de DbRawSqlQuery<TElement>).
Implementación explícita de interfacesMétodo privado IDbAsyncEnumerable.GetAsyncEnumerator Devuelve una IDbAsyncEnumerable que, cuando se enumera, ejecutará la consulta SQL en la base de datos. (Se hereda de DbRawSqlQuery<TElement>).
Implementación explícita de interfacesMétodo privado IDbAsyncEnumerable<TElement>.GetAsyncEnumerator Devuelve una IDbAsyncEnumerator<T> que, al enumerarse, ejecutará la consulta SQL en la base de datos. (Se hereda de DbRawSqlQuery<TElement>).

Superior

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Vea también

Referencia

System.Data.Entity.Infrastructure (Espacio de nombres)