ChangeTracker.TrackGraph Méthode

Définition

Espace de noms:

Microsoft.EntityFrameworkCore.ChangeTracking

Assembly:

Microsoft.EntityFrameworkCore.dll

Paquet:

Microsoft.EntityFrameworkCore v8.0.0

Surcharges

TrackGraph(Object, Action<EntityEntryGraphNode>)

Commence le suivi d’une entité et de toutes les entités accessibles en parcourant ses propriétés de navigation. Traversal étant récursif, les propriétés de navigation de toutes les entités découvertes sont également analysées. Le spécifié callback est appelé pour chaque entité découverte et doit définir le State dans lequel chaque entité doit être suivie. Si aucun état n’est défini, l’entité reste sans suivi.

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

Commence le suivi d’une entité et de toutes les entités accessibles en parcourant ses propriétés de navigation. Traversal étant récursif, les propriétés de navigation de toutes les entités découvertes sont également analysées. Le spécifié callback est appelé pour chaque entité découverte et doit définir le State dans lequel chaque entité doit être suivie. Si aucun état n’est défini, l’entité reste sans suivi.

TrackGraph(Object, Action<EntityEntryGraphNode>)

Commence le suivi d’une entité et de toutes les entités accessibles en parcourant ses propriétés de navigation. Traversal étant récursif, les propriétés de navigation de toutes les entités découvertes sont également analysées. Le spécifié callback est appelé pour chaque entité découverte et doit définir le State dans lequel chaque entité doit être suivie. Si aucun état n’est défini, l’entité reste sans suivi.

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))

Paramètres

rootEntity

Object

Entité à partir de laquelle commencer la traversée.

callback

Action<EntityEntryGraphNode>

Action permettant de configurer les informations de suivi des modifications pour chaque entité. Pour que l’entité commence à faire l’objet d’un suivi, le State doit être défini.

Remarques

Cette méthode est conçue pour être utilisée dans des scénarios déconnectés où les entités sont récupérées à l’aide d’une instance du contexte, puis les modifications sont enregistrées à l’aide d’une autre instance du contexte. Par exemple, un service web où un appel de service récupère des entités de la base de données et un autre appel de service conserve toutes les modifications apportées aux entités. Chaque appel de service utilise une nouvelle instance du contexte qui est supprimé une fois l’appel terminé.

Si une entité déjà suivie par le contexte est découverte, cette entité n’est pas traitée (et ses propriétés de navigation ne sont pas parcourues).

Pour plus d’informations et d’exemples, consultez Suivi des modifications EF Core .

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

Commence le suivi d’une entité et de toutes les entités accessibles en parcourant ses propriétés de navigation. Traversal étant récursif, les propriétés de navigation de toutes les entités découvertes sont également analysées. Le spécifié callback est appelé pour chaque entité découverte et doit définir le State dans lequel chaque entité doit être suivie. Si aucun état n’est défini, l’entité reste sans suivi.

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))

Paramètres de type

TState

Type de l’objet d’état.

Paramètres

rootEntity

Object

Entité à partir de laquelle commencer la traversée.

state

TState

Objet d’état arbitraire passé au rappel.

callback

Func<EntityEntryGraphNode<TState>,Boolean>

Délégué pour configurer les informations de suivi des modifications pour chaque entité. Le deuxième paramètre du rappel est l’objet d’état arbitraire passé ci-dessus. L’itération du graphique ne se poursuit pas vers le bas si le rappel retourne false.

Remarques

Cette méthode est conçue pour être utilisée dans des scénarios déconnectés où les entités sont récupérées à l’aide d’une instance du contexte, puis les modifications sont enregistrées à l’aide d’une autre instance du contexte. Par exemple, un service web où un appel de service récupère des entités de la base de données et un autre appel de service conserve toutes les modifications apportées aux entités. Chaque appel de service utilise une nouvelle instance du contexte qui est supprimé une fois l’appel terminé.

En règle générale, la traversée du graphique doit s’arrêter chaque fois qu’une entité déjà suivie est rencontrée ou lorsqu’une entité qui ne doit pas être suivie est atteinte. Pour ce comportement classique, utilisez la TrackGraph(Object, Action<EntityEntryGraphNode>) surcharge. Cette surcharge, en revanche, permet au rappel de décider quand le parcours prendra fin, mais il incombe ensuite à l’appelant de s’assurer que le parcours n’entrera pas dans une boucle infinie.

Pour plus d’informations et d’exemples, consultez Suivi des modifications EF Core .