DbRawSqlQuery (Clase)

[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 elementos que no son entidades que se crean a partir de un DbContext y se ejecutan usando la conexión de ese contexto. Las instancias de esta clase se obtienen a partir de la instancia de Database. 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 entidades se crean mediante SqlQuery(String, Object[]). Vea DbRawSqlQuery<TElement> en el caso de una versión genérica de esta clase.

Jerarquía de herencia

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

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

Sintaxis

'Declaración
<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")> _
<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")> _
Public Class DbRawSqlQuery _
    Implements IEnumerable, IListSource, IDbAsyncEnumerable
'Uso
Dim instance As DbRawSqlQuery
[SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")]
[SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")]
public class DbRawSqlQuery : IEnumerable, 
    IListSource, IDbAsyncEnumerable
[SuppressMessageAttribute(L"Microsoft.Naming", L"CA1710:IdentifiersShouldHaveCorrectSuffix")]
[SuppressMessageAttribute(L"Microsoft.Design", L"CA1010:CollectionsShouldImplementGenericInterface")]
public ref class DbRawSqlQuery : IEnumerable, 
    IListSource, IDbAsyncEnumerable
[<SuppressMessageAttribute("Microsoft.Naming", "CA1710:IdentifiersShouldHaveCorrectSuffix")>]
[<SuppressMessageAttribute("Microsoft.Design", "CA1010:CollectionsShouldImplementGenericInterface")>]
type DbRawSqlQuery =  
    class 
        interface IEnumerable 
        interface IListSource 
        interface IDbAsyncEnumerable 
    end
public class DbRawSqlQuery implements IEnumerable, IListSource, IDbAsyncEnumerable

El tipo DbRawSqlQuery expone los siguientes miembros.

Métodos

  Name Descripción
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 Equals Especifica si la consulta es o no igual al objeto especificado. (Invalida a Object.Equals(Object)).
Método protegido Finalize (Se hereda de Object).
Método público ForEachAsync(Action<Object>) Enumera de forma asincrónica los resultados de la consulta y realiza la acción especificada en cada elemento.
Método público ForEachAsync(Action<Object>, CancellationToken) Enumera de forma asincrónica los resultados de la consulta y realiza la acción especificada en cada elemento.
Método público GetEnumerator Devuelve una IEnumerator que, cuando se enumera, ejecutará la consulta SQL en la base de datos.
Método público GetHashCode Obtiene el código hash asociado a la consulta. (Invalida a Object.GetHashCode()).
Método público GetType Obtiene el tipo asociado a la consulta.
Método protegido MemberwiseClone (Se hereda de Object).
Método público ToListAsync() Crea una List<T> a partir de la consulta enumerándola de forma asincrónica.
Método público ToListAsync(CancellationToken) Crea una List<T> a partir de la consulta enumerándola de forma asincrónica.
Método público ToString Devuelve un objeto String que contiene la cadena SQL que se estableció cuando se creó la consulta.No se incluyen los parámetros. (Invalida a Object.ToString()).

Superior

Implementaciones de interfaz explícita

  Name Descripción
Implementación explícita de interfacesPropiedad privada IListSource.ContainsListCollection Devuelve false.
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.
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.

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)