EntityFrameworkQueryableExtensions.AsNoTracking<TEntity> Método

Definição

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v8.0.0

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.

public static System.Linq.IQueryable<TEntity> AsNoTracking<TEntity> (this System.Linq.IQueryable<TEntity> source) where TEntity : class;

static member AsNoTracking : System.Linq.IQueryable<'Entity (requires 'Entity : null)> -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)

<Extension()>
Public Function AsNoTracking(Of TEntity As Class) (source As IQueryable(Of TEntity)) As IQueryable(Of TEntity)

Parâmetros de tipo

TEntity

O tipo de entidade que está sendo consultada.

Parâmetros

source

IQueryable<TEntity>

Consulta de fonte.

Retornos

IQueryable<TEntity>

Uma nova consulta em que o conjunto de resultados não será acompanhado pelo contexto.

Exceções

ArgumentNullException

source é null.

Comentários

Desabilitar o controle de alterações é útil para cenários somente leitura porque evita a sobrecarga de configurar o controle de alterações para cada instância de entidade. Você não deve desabilitar o controle de alterações se quiser manipular instâncias de entidade e persistir essas alterações no banco de dados usando SaveChanges().

A resolução de identidade não será executada. Se uma entidade com uma determinada chave estiver em um resultado diferente no conjunto de resultados, elas serão instâncias diferentes.

O comportamento de acompanhamento padrão para consultas pode ser controlado por QueryTrackingBehavior.

Consulte Consultas sem acompanhamento no EF Core para obter mais informações e exemplos.