Partilhar via


IIncludableQueryable<TEntity,TProperty> Interface

Definição

Dá suporte a operadores de encadeamento Include/ThenInclude consultáveis.

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

O tipo de entidade.

Este parâmetro de tipo é covariante. Isso significa que é possível usar o tipo especificado ou qualquer tipo mais derivado. Para obter mais informações sobre covariância e contravariância, consulte Covariância e contravariância em genéricos.
TProperty

O tipo de propriedade.

Este parâmetro de tipo é covariante. Isso significa que é possível usar o tipo especificado ou qualquer tipo mais derivado. Para obter mais informações sobre covariância e contravariância, consulte Covariância e contravariância em genéricos.
Implementações

Comentários

Consulte Implementação de provedores e extensões de banco de dados e Como funcionam as consultas do EF Core para obter mais informações e exemplos.

Métodos de Extensão

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

Especifique a chave de partição para partição usada para a consulta. Necessário ao usar um token de recurso que fornece permissão com base em uma chave de partição para autenticação,

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

Determina de forma assíncrona se todos os elementos de uma sequência atendem a uma condição.

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

Determina de forma assíncrona se algum elemento de uma sequência atende a uma condição.

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

Determina de forma assíncrona se uma sequência contém elementos.

AsAsyncEnumerable<TSource>(IQueryable<TSource>)

Retorna um IAsyncEnumerable<T> que pode ser enumerado de forma assíncrona.

AsNoTracking<TEntity>(IQueryable<TEntity>)

O rastreador de alterações não rastreará nenhuma das entidades retornadas de uma consulta LINQ. Se as instâncias de entidade forem modificadas, isso não será detectado pelo rastreador de alterações e SaveChanges() não persistirá essas alterações no banco de dados.

AsNoTrackingWithIdentityResolution<TEntity>(IQueryable<TEntity>)

O rastreador de alterações não rastreará nenhuma das entidades retornadas de uma consulta LINQ. Se as instâncias de entidade forem modificadas, isso não será detectado pelo rastreador de alterações e SaveChanges() não persistirá essas alterações no banco de dados.

AsTracking<TEntity>(IQueryable<TEntity>)

Retorna uma nova consulta em que o rastreador de alterações controlará as alterações de todas as entidades retornadas. Qualquer modificação nas instâncias de entidade será detectada e persistida no banco de dados durante SaveChanges().

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

Retorna uma nova consulta em que o rastreador de alterações manterá o controle das alterações ou não para todas as entidades retornadas, dependendo do valor do parâmetro 'track'. Durante o acompanhamento, qualquer modificação nas instâncias de entidade será detectada e persistida no banco de dados durante SaveChanges(). Quando não estiver rastreando, se as instâncias de entidade forem modificadas, isso não será detectado pelo rastreador de alterações e SaveChanges() não persistirá essas alterações no banco de dados.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a média de uma sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Determina de forma assíncrona se uma sequência contém um elemento especificado usando o comparador de igualdade padrão.

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

Retorna de forma assíncrona o número de elementos em uma sequência que satisfaz uma condição.

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

Retorna de forma assíncrona o número de elementos em uma sequência.

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

Retorna de forma assíncrona o elemento em um índice especificado em uma sequência.

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

Retorna de forma assíncrona o elemento em um índice especificado em uma sequência ou um valor padrão se o índice estiver fora do intervalo.

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

Retorna de forma assíncrona o primeiro elemento de uma sequência que atende a uma condição especificada.

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

Retorna de forma assíncrona o primeiro elemento de uma sequência.

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

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

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

Retorna de forma assíncrona o primeiro elemento de uma sequência ou um valor padrão se a sequência não contiver elementos.

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

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

IgnoreAutoIncludes<TEntity>(IQueryable<TEntity>)

Especifica que a consulta LINQ atual do Entity Framework não deve ter nenhuma navegação carregada no nível do modelo aplicada.

IgnoreQueryFilters<TEntity>(IQueryable<TEntity>)

Especifica que a consulta LINQ atual do Entity Framework não deve ter filtros de consulta de entidade no nível do modelo aplicados.

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

Especifica entidades relacionadas a serem incluídas nos resultados da consulta. A propriedade de navegação a ser incluída é especificada a partir do tipo de entidade que está sendo consultada (TEntity). Outras propriedades de navegação a serem incluídas podem ser acrescentadas, separadas pelo caractere '.'.

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

Especifica entidades relacionadas a serem incluídas nos resultados da consulta. A propriedade de navegação a ser incluída é especificada a partir do tipo de entidade que está sendo consultada (TEntity). Se você quiser incluir tipos adicionais com base nas propriedades de navegação do tipo que está sendo incluído, encadeie uma chamada para ThenInclude<TEntity,TPreviousProperty,TProperty>(IIncludableQueryable<TEntity, IEnumerable<TPreviousProperty>>, Expression<Func<TPreviousProperty, TProperty>>) após essa chamada.

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

Retorna de forma assíncrona o último elemento de uma sequência que atende a uma condição especificada.

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

Retorna de forma assíncrona o último elemento de uma sequência.

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

Retorna de forma assíncrona o último elemento de uma sequência que atende a uma condição especificada ou um valor padrão se nenhum elemento desse tipo for encontrado.

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

Retorna de forma assíncrona o último elemento de uma sequência ou um valor padrão se a sequência não contiver elementos.

Load<TSource>(IQueryable<TSource>)

Enumera a consulta. Ao usar o Entity Framework, isso faz com que os resultados da consulta sejam carregados no contexto associado. Isso equivale a chamar ToList e, em seguida, jogar fora a lista (sem a sobrecarga de realmente criar a lista).

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

Enumera de forma assíncrona a consulta. Ao usar o Entity Framework, isso faz com que os resultados da consulta sejam carregados no contexto associado. Isso equivale a chamar ToList e, em seguida, jogar fora a lista (sem a sobrecarga de realmente criar a lista).

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

Retorna de forma assíncrona um Int64 que representa o número de elementos em uma sequência que satisfaz uma condição.

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

Retorna de forma assíncrona um Int64 que representa o número total de elementos em uma sequência.

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

Retorna de forma assíncrona o valor máximo de uma sequência.

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

Invoca de forma assíncrona uma função de projeção em cada elemento de uma sequência e retorna o valor máximo resultante.

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

Retorna de forma assíncrona o valor mínimo de uma sequência.

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

Invoca de forma assíncrona uma função de projeção em cada elemento de uma sequência e retorna o valor mínimo resultante.

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

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

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

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

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

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

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

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Calcula de forma assíncrona a soma da sequência de valores obtida invocando uma função de projeção em cada elemento da sequência de entrada.

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

Adiciona uma marca à coleção de marcas associadas a uma consulta LINQ do EF. As marcas são anotações de consulta que podem fornecer informações de rastreamento contextual em diferentes pontos no pipeline de consulta.

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

Adiciona uma marca à coleção de marcas associadas a uma consulta LINQ do EF com o nome do arquivo de origem e a linha em que o método foi chamado que pode fornecer informações de rastreamento contextual em diferentes pontos no pipeline de consulta.

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

Especifica dados relacionados adicionais a serem incluídos com base em um tipo relacionado que acabou de ser incluído.

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

Cria de forma assíncrona uma matriz de um IQueryable<T> enumerando-a de forma assíncrona.

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

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

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

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

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

Cria um Dictionary<TKey,TValue> de um IQueryable<T> 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.

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

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

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

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

AsSingleQuery<TEntity>(IQueryable<TEntity>)

Retorna uma nova consulta configurada para carregar as coleções na consulta resulta em uma única consulta de banco de dados.

AsSplitQuery<TEntity>(IQueryable<TEntity>)

Retorna uma nova consulta configurada para carregar as coleções nos resultados da consulta por meio de consultas de banco de dados separadas.

ExecuteDelete<TSource>(IQueryable<TSource>)

Exclui todas as linhas de banco de dados para as instâncias de entidade que correspondem à consulta LINQ do banco de dados.

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

Exclui as linhas de banco de dados de forma assíncrona para as instâncias de entidade que correspondem à consulta LINQ do banco de dados.

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

Atualizações todas as linhas de banco de dados para as instâncias de entidade que correspondem à consulta LINQ do banco de dados.

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

Atualiza as linhas de banco de dados de forma assíncrona para as instâncias de entidade que correspondem à consulta LINQ do banco de dados.

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

Cria uma consulta LINQ com base em uma consulta SQL bruta.

Se o provedor de banco de dados der suporte à composição no SQL fornecido, você poderá compor sobre a consulta SQL bruta usando operadores LINQ – context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada de usuário para proteger contra um ataque de injeção de SQL. Você pode incluir detentores de parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Essa sobrecarga também aceita instâncias DbParameter como valores de parâmetro. Isso permite que você use parâmetros nomeados na cadeia de caracteres de consulta SQL – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

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

Cria uma consulta LINQ com base em uma cadeia de caracteres interpolada que representa uma consulta SQL.

Se o provedor de banco de dados der suporte à composição no SQL fornecido, você poderá compor sobre a consulta SQL bruta usando operadores LINQ – context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada do usuário para proteger contra um ataque de injeção de SQL. Você pode incluir espaços reservados de parâmetro interpolados na cadeia de caracteres de consulta SQL. Todos os valores de parâmetro interpolados fornecidos serão convertidos automaticamente em um DbParameter – context.Blogs.FromSql($"SELECT * FROM [dbo].[SearchBlogs]({userSuppliedSearchTerm})").

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

Cria uma consulta LINQ com base em uma consulta SQL bruta.

Se o provedor de banco de dados der suporte à composição no SQL fornecido, você poderá compor sobre a consulta SQL bruta usando operadores LINQ – context.Blogs.FromSql("SELECT * FROM dbo.Blogs").OrderBy(b => b.Name).

Assim como acontece com qualquer API que aceite o SQL, é importante parametrizar qualquer entrada do usuário para proteger contra um ataque de injeção de SQL. Você pode incluir os espaços reservados para parâmetros na cadeia de caracteres de consulta SQL e, em seguida, fornecer valores de parâmetro como argumentos adicionais. Todos os valores de parâmetro fornecidos serão convertidos automaticamente em um DbParameter – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({0})", userSuppliedSearchTerm).

Você também pode construir um DbParameter e fornecê-lo como um valor de parâmetro. Isso permite que você use parâmetros nomeados na cadeia de caracteres de consulta SQL – context.Blogs.FromSql("SELECT * FROM [dbo].[SearchBlogs]({@searchTerm})", new SqlParameter("@searchTerm", userSuppliedSearchTerm))

Aplica-se a