Compartir a través de


IIncludableQueryable<TEntity,TProperty> Interfaz

Definición

Admite operadores de encadenamiento Include/ThenInclude consultables.

public interface IIncludableQueryable<out TEntity,out TProperty> : System.Collections.Generic.IEnumerable<out TEntity>, System.Linq.IQueryable<out TEntity>
type IIncludableQueryable<'Entity, 'Property> = interface
    interface IQueryable<'Entity>
    interface seq<'Entity>
    interface IEnumerable
    interface IQueryable
Public Interface IIncludableQueryable(Of Out TEntity, Out TProperty)
Implements IEnumerable(Of Out TEntity), IQueryable(Of Out TEntity)

Parámetros de tipo

TEntity

El tipo de entidad.

Este parámetro de tipo es covariante, es decir, puede usar el tipo que haya especificado o cualquier tipo más derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.
TProperty

Tipo de propiedad.

Este parámetro de tipo es covariante, es decir, puede usar el tipo que haya especificado o cualquier tipo más derivado. Si desea obtener más información sobre la covarianza y la contravarianza, consulte Covarianza y contravarianza en genéricos.
Implementaciones

Comentarios

Consulte Implementación de proveedores y extensiones de bases de datos yCómo funcionan las consultas de EF Core para obtener más información y ejemplos.

Métodos de extensión

WithPartitionKey<TEntity>(IQueryable<TEntity>, String)

Especifique la clave de partición para la partición usada para la consulta. Necesario cuando se usa un token de recurso que proporciona permiso basado en una clave de partición para la autenticación,

AllAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Determina de forma asincrónica si todos los elementos de una secuencia cumplen una condición.

AnyAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Determina de forma asincrónica si algún elemento de una secuencia cumple una condición.

AnyAsync<TSource>(IQueryable<TSource>, CancellationToken)

Determina de forma asincrónica si una secuencia contiene elementos.

AsAsyncEnumerable<TSource>(IQueryable<TSource>)

Devuelve un IAsyncEnumerable<T> objeto que se puede enumerar de forma asincrónica.

AsNoTracking<TEntity>(IQueryable<TEntity>)

El seguimiento de cambios no realizará un seguimiento de ninguna de las entidades que se devuelven desde una consulta LINQ. Si se modifican las instancias de entidad, el seguimiento de cambios no lo detectará y SaveChanges() no conservará esos cambios en la base de datos.

AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)

El seguimiento de cambios no realizará un seguimiento de ninguna de las entidades que se devuelven desde una consulta LINQ. Si se modifican las instancias de entidad, el seguimiento de cambios no lo detectará y SaveChanges() no conservará esos cambios en la base de datos.

AsTracking<TEntity>(IQueryable<TEntity>)

Devuelve una nueva consulta en la que el rastreador de cambios realizará un seguimiento de los cambios de todas las entidades que se devuelven. Cualquier modificación de las instancias de entidad se detectará y se conservará en la base de datos durante SaveChanges().

AsTracking<TEntity>(IQueryable<TEntity>, QueryTrackingBehavior)

Devuelve una nueva consulta en la que el rastreador de cambios realizará un seguimiento de los cambios o no para todas las entidades que se devuelven, en función del valor del parámetro "track". Al realizar el seguimiento, se detectará cualquier modificación en las instancias de entidad y se conservará en la base de datos durante SaveChanges(). Cuando no se realiza el seguimiento, si se modifican las instancias de entidad, el seguimiento de cambios no lo detectará y SaveChanges() no conservará esos cambios en la base de datos.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

AverageAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

Calcula de forma asincrónica el promedio de una secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

ContainsAsync<TSource>(IQueryable<TSource>, TSource, CancellationToken)

Determina de forma asincrónica si una secuencia contiene un elemento especificado mediante el comparador de igualdad predeterminado.

CountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Devuelve de forma asincrónica el número de elementos de una secuencia que cumplen una condición.

CountAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica el número de elementos de una secuencia.

ElementAtAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

Devuelve de forma asincrónica el elemento en un índice especificado de una secuencia.

ElementAtOrDefaultAsync<TSource>(IQueryable<TSource>, Int32, CancellationToken)

Devuelve de forma asincrónica el elemento en un índice especificado de una secuencia o un valor predeterminado si el índice está fuera del intervalo.

FirstAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Devuelve de forma asincrónica el primer elemento de una secuencia que satisface una condición especificada.

FirstAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica el primer elemento de una secuencia.

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Devuelve de forma asincrónica el primer elemento de una secuencia que satisface una condición especificada o un valor predeterminado si no se encuentra dicho elemento.

FirstOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica el primer elemento de una secuencia o un valor predeterminado si la secuencia no contiene elementos.

ForEachAsync<T>(IQueryable<T>, Action<T>, CancellationToken)

Enumera asincrónicamente los resultados de la consulta y realiza la acción especificada en cada elemento.

IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)

Especifica que la consulta LINQ de Entity Framework actual no debe tener aplicadas navegaciones diligentes de nivel de modelo.

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

Especifica que la consulta LINQ de Entity Framework actual no debe tener aplicado ningún filtro de consulta de entidad de nivel de modelo.

Include<TEntity>(IQueryable<TEntity>, String)

Especifica las entidades relacionadas que se van a incluir en los resultados de la consulta. La propiedad de navegación que se va a incluir se especifica a partir del tipo de entidad que se consulta (TEntity). Las propiedades de navegación adicionales que se van a incluir se pueden anexar, separadas por el carácter ".".

Include<TEntity,TProperty>(IQueryable<TEntity>, Expression<Func<TEntity,TProperty>>)

Especifica las entidades relacionadas que se van a incluir en los resultados de la consulta. La propiedad de navegación que se va a incluir se especifica a partir del tipo de entidad que se consulta (TEntity). Si desea incluir tipos adicionales en función de las propiedades de navegación del tipo que se va a incluir, encadene una llamada a ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) después de esta llamada.

LastAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Devuelve de forma asincrónica el último elemento de una secuencia que satisface una condición especificada.

LastAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica el último elemento de una secuencia.

LastOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Devuelve de forma asincrónica el último elemento de una secuencia que satisface una condición especificada o un valor predeterminado si no se encuentra dicho elemento.

LastOrDefaultAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica el último elemento de una secuencia o un valor predeterminado si la secuencia no contiene ningún elemento.

Load<TSource>(IQueryable<TSource>)

Enumera la consulta. Al usar Entity Framework, esto hace que los resultados de la consulta se carguen en el contexto asociado. Esto equivale a llamar a ToList y, a continuación, eliminar la lista (sin la sobrecarga de crear realmente la lista).

LoadAsync<TSource>(IQueryable<TSource>, CancellationToken)

Enumera de forma asincrónica la consulta. Al usar Entity Framework, esto hace que los resultados de la consulta se carguen en el contexto asociado. Esto equivale a llamar a ToList y, a continuación, eliminar la lista (sin la sobrecarga de crear realmente la lista).

LongCountAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Devuelve de forma asincrónica un Int64 objeto que representa el número de elementos de una secuencia que satisface una condición.

LongCountAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica un Int64 objeto que representa el número total de elementos de una secuencia.

MaxAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica el valor máximo de una secuencia.

MaxAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

Invoca de forma asincrónica una función de proyección en cada elemento de una secuencia y devuelve el valor máximo resultante.

MinAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica el valor mínimo de una secuencia.

MinAsync<TSource,TResult>(IQueryable<TSource>, Expression<Func<TSource,TResult>>, CancellationToken)

Invoca de forma asincrónica una función de proyección en cada elemento de una secuencia y devuelve el valor resultante mínimo.

SingleAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Devuelve de forma asincrónica el único elemento de una secuencia que satisface una condición especificada y produce una excepción si existe más de un elemento de este tipo.

SingleAsync<TSource>(IQueryable<TSource>, CancellationToken)

Devuelve de forma asincrónica el único elemento de una secuencia y produce una excepción si no hay exactamente un elemento en la secuencia.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Boolean>>, CancellationToken)

Devuelve de forma asincrónica el único elemento de una secuencia que satisface una condición especificada o un valor predeterminado si no existe dicho elemento; Este método produce una excepción si más de un elemento cumple la condición.

SingleOrDefaultAsync<TSource>(IQueryable<TSource>, 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.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Decimal>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Double>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int32>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Int64>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Decimal>>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Double>>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int32>>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Int64>>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Nullable<Single>>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

SumAsync<TSource>(IQueryable<TSource>, Expression<Func<TSource,Single>>, CancellationToken)

Calcula de forma asincrónica la suma de la secuencia de valores que se obtiene invocando una función de proyección en cada elemento de la secuencia de entrada.

TagWith<T>(IQueryable<T>, String)

Agrega una etiqueta a la colección de etiquetas asociadas a una consulta LINQ de EF. Las etiquetas son anotaciones de consulta que pueden proporcionar información de seguimiento contextual en distintos puntos de la canalización de consulta.

TagWithCallSite<T>(IQueryable<T>, String, Int32)

Agrega una etiqueta a la colección de etiquetas asociadas a una consulta LINQ de EF con el nombre de archivo de origen y la línea donde se llamó al método que puede proporcionar información de seguimiento contextual en distintos puntos de la canalización de consulta.

ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity,TPreviousProperty>, Expression<Func<TPreviousProperty,TProperty>>)

Especifica datos relacionados adicionales que se incluirán más en función de un tipo relacionado que se acaba de incluir.

ToArrayAsync<TSource>(IQueryable<TSource>, CancellationToken)

Crea de forma asincrónica una matriz a partir de una IQueryable<T> enumeración asincrónica.

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, IEqualityComparer<TKey>, CancellationToken)

Crea un a Dictionary<TKey,TValue> partir de un IQueryable<T> elemento enumerando de forma asincrónica según una función de selector de claves especificada y un comparador.

ToDictionaryAsync<TSource,TKey>(IQueryable<TSource>, Func<TSource,TKey>, CancellationToken)

Crea un a Dictionary<TKey,TValue> partir de un IQueryable<T> mediante la enumeración asincrónica según una función de selector de claves especificada.

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, IEqualityComparer<TKey>, CancellationToken)

Crea un objeto Dictionary<TKey,TValue> a partir de un IQueryable<T> elemento enumerando de forma asincrónica según una función de selector de claves especificada, un comparador y una función de selector de elementos.

ToDictionaryAsync<TSource,TKey,TElement>(IQueryable<TSource>, Func<TSource,TKey>, Func<TSource,TElement>, CancellationToken)

Crea a Dictionary<TKey,TValue> partir de un IQueryable<T> elemento enumerando de forma asincrónica según un selector de claves especificado y una función de selector de elementos.

ToListAsync<TSource>(IQueryable<TSource>, CancellationToken)

Crea de forma asincrónica un a List<T> partir de un IQueryable<T> elemento enumerando de forma asincrónica.

AsSingleQuery<TEntity>(IQueryable<TEntity>)

Devuelve una nueva consulta que está configurada para cargar las colecciones en los resultados de la consulta en una sola consulta de base de datos.

AsSplitQuery<TEntity>(IQueryable<TEntity>)

Devuelve una nueva consulta que está configurada para cargar las colecciones en los resultados de la consulta a través de consultas de base de datos independientes.

ExecuteDelete<TSource>(IQueryable<TSource>)

Elimina todas las filas de base de datos de las instancias de entidad que coinciden con la consulta LINQ de la base de datos.

ExecuteDeleteAsync<TSource>(IQueryable<TSource>, CancellationToken)

Elimina asincrónicamente las filas de base de datos de las instancias de entidad que coinciden con la consulta LINQ de la base de datos.

ExecuteUpdate<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>)

Novedades todas las filas de base de datos de las instancias de entidad que coinciden con la consulta LINQ de la base de datos.

ExecuteUpdateAsync<TSource>(IQueryable<TSource>, Expression<Func<SetPropertyCalls<TSource>,SetPropertyCalls<TSource>>>, CancellationToken)

Actualiza asincrónicamente las filas de base de datos de las instancias de entidad que coinciden con la consulta LINQ de la base de datos.

FromSql<TEntity>(IQueryable<TEntity>, RawSqlString, Object[])
Obsoleto..

Crea una consulta LINQ basada en una consulta SQL sin formato.

Si el proveedor de base de datos admite la redacción en el SQL proporcionado, puede crear sobre la consulta SQL sin procesar mediante operadores LINQ: context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Al igual que con cualquier API que acepte SQL, es importante parametrizar cualquier entrada de usuario para protegerse frente a un ataque por inyección de código SQL. Puede incluir marcadores de posición de parámetros en la cadena de consulta SQL y, a continuación, proporcionar valores de parámetro como argumentos adicionales. Los valores de parámetro que proporcione se convertirán automáticamente en dbParameter: context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Esta sobrecarga también acepta instancias de DbParameter como valores de parámetro. Esto le permite usar parámetros con nombre en la cadena de consulta SQL: context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

FromSql<TEntity>(IQueryable<TEntity>, FormattableString)
Obsoleto..

Crea una consulta LINQ basada en una cadena interpolada que representa una consulta SQL.

Si el proveedor de base de datos admite la redacción en el SQL proporcionado, puede crear sobre la consulta SQL sin procesar mediante operadores LINQ: context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Al igual que con cualquier API que acepte SQL, es importante parametrizar cualquier entrada de usuario para protegerse frente a un ataque por inyección de código SQL. Puede incluir marcadores de posición de parámetro interpolados en la cadena de consulta SQL. Los valores de parámetro interpolados que proporcione se convertirán automáticamente en dbParameter: context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

FromSql<TEntity>(IQueryable<TEntity>, String, Object[])

Crea una consulta LINQ basada en una consulta SQL sin formato.

Si el proveedor de base de datos admite la redacción en el SQL proporcionado, puede crear sobre la consulta SQL sin procesar mediante operadores LINQ: context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Al igual que con cualquier API que acepte SQL, es importante parametrizar cualquier entrada de usuario para protegerse frente a un ataque por inyección de código SQL. Puede incluir marcadores de posición de parámetros en la cadena de consulta SQL y, a continuación, proporcionar valores de parámetro como argumentos adicionales. Los valores de parámetro que proporcione se convertirán automáticamente en dbParameter: context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

También puede construir un DbParameter y proporcionarlo como un valor de parámetro. Esto le permite usar parámetros con nombre en la cadena de consulta SQL: context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

Se aplica a