ChangeTracker.TrackGraph Método

Definição

Namespace:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Pacote:

Microsoft.EntityFrameworkCore v10.0.0

Sobrecargas

Nome	Descrição
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 todas as entidades descobertas também serão verificadas. O especificado callback é chamado para cada entidade descoberta e deve definir no State qual cada entidade deve ser rastreada. Se nenhum estado estiver definido, a entidade permanecerá não rastreada.
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 todas as entidades descobertas também serão verificadas. O especificado callback é chamado para cada entidade descoberta e deve definir no State qual cada entidade deve ser rastreada. Se nenhum estado estiver definido, a entidade permanecerá não rastreada.

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 todas as entidades descobertas também serão verificadas. O especificado callback é chamado para cada entidade descoberta e deve definir no State qual cada entidade deve ser rastreada. Se nenhum estado estiver definido, a entidade permanecerá não rastreada.

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 rastreada, ela State deve ser definida.

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 as 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á está controlada pelo contexto, essa entidade não será processada (e suas propriedades de navegação não serão percorrida).

Consulte o 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 todas as entidades descobertas também serão verificadas. O especificado callback é chamado para cada entidade descoberta e deve definir no State qual cada entidade deve ser rastreada. Se nenhum estado estiver definido, a entidade permanecerá não rastreada.

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 de estado.

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 as 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 o controle de alterações do EF Core para obter mais informações e exemplos.