EntityState Énumération
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
État d'un objet entité.
Cette énumération prend en charge une combinaison au niveau du bit de ses valeurs membres.
public enum class EntityState
[System.Flags]
public enum EntityState
[System.Flags]
[System.ComponentModel.DataAnnotations.BindableType(IsBindable=false)]
public enum EntityState
[<System.Flags>]
type EntityState =
[<System.Flags>]
[<System.ComponentModel.DataAnnotations.BindableType(IsBindable=false)>]
type EntityState =
Public Enum EntityState
- Héritage
- Attributs
Champs
Added | 4 | L'objet est nouveau, a été ajouté au contexte de l'objet et la méthode SaveChanges() n'a pas été appelée. Une fois les modifications enregistrées, l'état de l'objet passe à Unchanged. Les objets dans l'état Added ne possèdent pas de valeurs d'origine dans ObjectStateEntry. |
Deleted | 8 | L'objet a été supprimé du contexte de l'objet. Une fois les modifications enregistrées, l'état de l'objet passe à Detached. |
Detached | 1 | L'objet existe mais ne fait pas l'objet d'un suivi. Une entité est dans cet état juste après avoir été créée et avant d'être ajoutée au contexte de l'objet. Une entité est également dans cet état après avoir été supprimée du contexte en appelant la méthode Detach(Object) ou si elle est chargée à l'aide d'un objet NoTrackingMergeOption. Aucune instance de ObjectStateEntry n'est associée aux objets dans l'état Detached. |
Modified | 16 | L'une des propriétés scalaires de l'objet a été modifiée et la méthode SaveChanges() n'a pas été appelée. Dans les entités POCO sans proxys de suivi des modifications, l'état des propriétés modifiées se transforme en Modified lorsque la méthode DetectChanges() est appelée. Une fois les modifications enregistrées, l'état de l'objet passe à Unchanged. |
Unchanged | 2 | L'objet n'a pas été modifié depuis son attachement au contexte ou depuis le dernier appel de la méthode SaveChanges(). |
Remarques
Le contexte de l'objet doit connaître l'état d'un objet pour enregistrer les modifications dans la source de données. Les objets ObjectStateEntry stockent les informations de l'objet EntityState. Les méthodes SaveChanges
de l'objet ObjectContext traitent les entités attachées au contexte et mettent à jour la source de données en fonction de l'objet EntityState de chaque objet. Pour plus d’informations, consultez Création, ajout, modification et suppression d’objets.
L'état des objets à l'intérieur d'un contexte d'objet est géré par l'objet ObjectStateManager. Pour déterminer l'état d'un objet, appelez l'une des méthodes ObjectStateManager suivantes : TryGetObjectStateEntry, GetObjectStateEntry ou GetObjectStateEntries. La propriété State de l'objet ObjectStateEntry définit l'état de l'objet.