EntityFrameworkQueryableExtensions.AsTracking Método

Definição

Namespace:

Microsoft.EntityFrameworkCore

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v8.0.0

Sobrecargas

AsTracking<TEntity>(IQueryable<TEntity>)

Retorna uma nova consulta em que o rastreador de alterações manterá o controle das alterações para 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 acompanhando, 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 manterá o controle das alterações para todas as entidades retornadas. Qualquer modificação nas instâncias de entidade será detectada e persistida no banco de dados durante SaveChanges().

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

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

<Extension()>
Public Function AsTracking(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 será acompanhado pelo contexto.

Exceções

ArgumentNullException

source é null.

Comentários

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

Consulte Acompanhamento de consultas no EF Core para obter mais informações e exemplos.

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 acompanhando, 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> AsTracking<TEntity> (this System.Linq.IQueryable<TEntity> source, Microsoft.EntityFrameworkCore.QueryTrackingBehavior track) where TEntity : class;

static member AsTracking : System.Linq.IQueryable<'Entity (requires 'Entity : null)> * Microsoft.EntityFrameworkCore.QueryTrackingBehavior -> System.Linq.IQueryable<'Entity (requires 'Entity : null)> (requires 'Entity : null)

<Extension()>
Public Function AsTracking(Of TEntity As Class) (source As IQueryable(Of TEntity), track As QueryTrackingBehavior) 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.

track

QueryTrackingBehavior

Indica se a consulta acompanhará os resultados ou não.

Retornos

IQueryable<TEntity>

Uma nova consulta em que o conjunto de resultados 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().

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

Consulte Acompanhamento de consultas no EF Core para obter mais informações e exemplos.