ChangeTracker.TrackGraph Método

Definição

Namespace:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v9.0.0

Sobrecargas

TrackGraph(Object, Action<EntityEntryGraphNode>)

Começa a acompanhar uma entidade e todas as entidades que podem ser acessadas atravessando suas propriedades de navegação. A passagem é recursiva, portanto, as propriedades de navegação de qualquer entidade descoberta também serão verificadas. O especificado callback é chamado para cada entidade descoberta e deve definir o State em que cada entidade deve ser controlada. Se nenhum estado for definido, a entidade permanecerá sem rastreamento.

TrackGraph<TState>(Object, TState, Func<EntityEntryGraphNode<TState>,Boolean>)

Começa a acompanhar uma entidade e todas as entidades que podem ser acessadas atravessando suas propriedades de navegação. A passagem é recursiva, portanto, as propriedades de navegação de qualquer entidade descoberta também serão verificadas. O especificado callback é chamado para cada entidade descoberta e deve definir o State em que cada entidade deve ser controlada. Se nenhum estado for definido, a entidade permanecerá sem rastreamento.

TrackGraph(Object, Action<EntityEntryGraphNode>)

Origem:

ChangeTracker.cs

Começa a acompanhar uma entidade e todas as entidades que podem ser acessadas atravessando suas propriedades de navegação. A passagem é recursiva, portanto, as propriedades de navegação de qualquer entidade descoberta também serão verificadas. O especificado callback é chamado para cada entidade descoberta e deve definir o State em que cada entidade deve ser controlada. Se nenhum estado for definido, a entidade permanecerá sem rastreamento.

public virtual void TrackGraph (object rootEntity, Action<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntryGraphNode> callback);

abstract member TrackGraph : obj * Action<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntryGraphNode> -> unit
override this.TrackGraph : obj * Action<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntryGraphNode> -> unit

Public Overridable Sub TrackGraph (rootEntity As Object, callback As Action(Of EntityEntryGraphNode))

Parâmetros

rootEntity

Object

A entidade da qual começar a percorrer.

callback

Action<EntityEntryGraphNode>

Uma ação para configurar as informações de controle de alterações para cada entidade. Para que a entidade comece a ser controlada, o State deve ser definido.

Comentários

Esse método foi projetado para uso em cenários desconectados em que as entidades são recuperadas usando uma instância do contexto e, em seguida, as alterações são salvas usando uma instância diferente do contexto. Um exemplo disso é um serviço Web em que uma chamada de serviço recupera entidades do banco de dados e outra chamada de serviço persiste quaisquer alterações nas entidades. Cada chamada de serviço usa uma nova instância do contexto que é descartada quando a chamada é concluída.

Se uma entidade for descoberta que já esteja controlada pelo contexto, essa entidade não será processada (e suas propriedades de navegação não serão percorridas).

Consulte Controle de alterações do EF Core para obter mais informações e exemplos.

TrackGraph<TState>(Object, TState, Func<EntityEntryGraphNode<TState>,Boolean>)

Origem:

ChangeTracker.cs

Começa a acompanhar uma entidade e todas as entidades que podem ser acessadas atravessando suas propriedades de navegação. A passagem é recursiva, portanto, as propriedades de navegação de qualquer entidade descoberta também serão verificadas. O especificado callback é chamado para cada entidade descoberta e deve definir o State em que cada entidade deve ser controlada. Se nenhum estado for definido, a entidade permanecerá sem rastreamento.

public virtual void TrackGraph<TState> (object rootEntity, TState state, Func<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntryGraphNode<TState>,bool> callback);

abstract member TrackGraph : obj * 'State * Func<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntryGraphNode<'State>, bool> -> unit
override this.TrackGraph : obj * 'State * Func<Microsoft.EntityFrameworkCore.ChangeTracking.EntityEntryGraphNode<'State>, bool> -> unit

Public Overridable Sub TrackGraph(Of TState) (rootEntity As Object, state As TState, callback As Func(Of EntityEntryGraphNode(Of TState), Boolean))

Parâmetros de tipo

TState

O tipo do objeto state.

Parâmetros

rootEntity

Object

A entidade da qual começar a percorrer.

state

TState

Um objeto de estado arbitrário passado para o retorno de chamada.

callback

Func<EntityEntryGraphNode<TState>,Boolean>

Um delegado para configurar as informações de controle de alterações para cada entidade. O segundo parâmetro para o retorno de chamada é o objeto de estado arbitrário passado acima. A iteração do grafo não continuará abaixo do grafo se o retorno de chamada retornar false.

Comentários

Esse método foi projetado para uso em cenários desconectados em que as entidades são recuperadas usando uma instância do contexto e, em seguida, as alterações são salvas usando uma instância diferente do contexto. Um exemplo disso é um serviço Web em que uma chamada de serviço recupera entidades do banco de dados e outra chamada de serviço persiste quaisquer alterações nas entidades. Cada chamada de serviço usa uma nova instância do contexto que é descartada quando a chamada é concluída.

Normalmente, a passagem do grafo deve parar sempre que uma entidade já controlada é encontrada ou quando uma entidade é atingida que não deve ser rastreada. Para esse comportamento típico, use a TrackGraph(Object, Action<EntityEntryGraphNode>) sobrecarga. Essa sobrecarga, por outro lado, permite que o retorno de chamada decida quando a passagem terminará, mas o ônus está no chamador para garantir que a passagem não insira um loop infinito.

Consulte Controle de alterações do EF Core para obter mais informações e exemplos.