ChangeTracker.TrackGraph Método

Definición

Espacio de nombres:

Microsoft.EntityFrameworkCore.ChangeTracking

Ensamblado:

Microsoft.EntityFrameworkCore.dll

Paquete:

Microsoft.EntityFrameworkCore v8.0.0

Sobrecargas

TrackGraph(Object, Action<EntityEntryGraphNode>)

Comienza a realizar un seguimiento de una entidad y de las entidades a las que se puede acceder mediante el recorrido de sus propiedades de navegación. El recorrido es recursivo, por lo que también se analizarán las propiedades de navegación de las entidades detectadas. Se llama al especificado para cada entidad detectada callback y debe establecer el objeto en el State que se debe realizar el seguimiento de cada entidad. Si no se establece ningún estado, la entidad permanece sin seguimiento.

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

Comienza a realizar un seguimiento de una entidad y de las entidades a las que se puede acceder mediante el recorrido de sus propiedades de navegación. El recorrido es recursivo, por lo que también se analizarán las propiedades de navegación de las entidades detectadas. Se llama al especificado para cada entidad detectada callback y debe establecer el objeto en el State que se debe realizar el seguimiento de cada entidad. Si no se establece ningún estado, la entidad permanece sin seguimiento.

TrackGraph(Object, Action<EntityEntryGraphNode>)

Comienza a realizar un seguimiento de una entidad y de las entidades a las que se puede acceder mediante el recorrido de sus propiedades de navegación. El recorrido es recursivo, por lo que también se analizarán las propiedades de navegación de las entidades detectadas. Se llama al especificado para cada entidad detectada callback y debe establecer el objeto en el State que se debe realizar el seguimiento de cada entidad. Si no se establece ningún estado, la entidad permanece sin seguimiento.

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

Entidad desde la que se va a comenzar el recorrido.

callback

Action<EntityEntryGraphNode>

Acción para configurar la información de seguimiento de cambios para cada entidad. Para que se realice el seguimiento de la entidad, se debe establecer .State

Comentarios

Este método está diseñado para su uso en escenarios desconectados en los que las entidades se recuperan mediante una instancia del contexto y, a continuación, los cambios se guardan mediante una instancia diferente del contexto. Un ejemplo de esto es un servicio web donde una llamada de servicio recupera entidades de la base de datos y otra llamada de servicio conserva los cambios realizados en las entidades. Cada llamada de servicio usa una nueva instancia del contexto que se elimina cuando se completa la llamada.

Si se detecta una entidad cuyo seguimiento ya ha realizado el contexto, esa entidad no se procesa (y sus propiedades de navegación no se recorren).

Consulte Seguimiento de cambios de EF Core para obtener más información y ejemplos.

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

Comienza a realizar un seguimiento de una entidad y de las entidades a las que se puede acceder mediante el recorrido de sus propiedades de navegación. El recorrido es recursivo, por lo que también se analizarán las propiedades de navegación de las entidades detectadas. Se llama al especificado para cada entidad detectada callback y debe establecer el objeto en el State que se debe realizar el seguimiento de cada entidad. Si no se establece ningún estado, la entidad permanece sin seguimiento.

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

Tipo del objeto de estado.

Parámetros

rootEntity

Object

Entidad desde la que se va a comenzar el recorrido.

state

TState

Objeto de estado arbitrario pasado a la devolución de llamada.

callback

Func<EntityEntryGraphNode<TState>,Boolean>

Delegado para configurar la información de seguimiento de cambios para cada entidad. El segundo parámetro de la devolución de llamada es el objeto de estado arbitrario pasado anteriormente. La iteración del gráfico no continuará hacia abajo si la devolución de llamada devuelve false.

Comentarios

Este método está diseñado para su uso en escenarios desconectados en los que las entidades se recuperan mediante una instancia del contexto y, a continuación, los cambios se guardan mediante una instancia diferente del contexto. Un ejemplo de esto es un servicio web donde una llamada de servicio recupera entidades de la base de datos y otra llamada de servicio conserva los cambios realizados en las entidades. Cada llamada de servicio usa una nueva instancia del contexto que se elimina cuando se completa la llamada.

Normalmente, el recorrido del grafo debe detenerse cada vez que se encuentra una entidad ya rastreada o cuando se alcanza una entidad que no se debe realizar un seguimiento. Para este comportamiento típico, use la TrackGraph(Object, Action<EntityEntryGraphNode>) sobrecarga . Esta sobrecarga, por otro lado, permite que la devolución de llamada decida cuándo finalizará el recorrido, pero la onus se encuentra en el autor de la llamada para asegurarse de que el recorrido no entrará en un bucle infinito.

Consulte Seguimiento de cambios de EF Core para obtener más información y ejemplos.