entity.reload( )

4D v18

entity.reload( )

Description

La méthode entity.reload( ) recharge en mémoire le contenu de l'entité à partir des informations stockées dans la table associée à la dataclass. Le rechargement est effectué uniquement si l'entité existe toujours avec la même clé primaire.

Résultat

L'objet retourné par entity.reload( ) contient les propriétés suivantes :

Propriété	Type	Description
success	booléen	Vrai si le rechargement a été effectué avec succès, sinon Faux.
status(*)	numérique	Code d'erreur, voir ci-dessous
statusText(*)	texte	Description de l'erreur, voir ci-dessous

(*) Les valeurs suivantes peuvent être retournées dans les propriétés status et statusText de l'objet Résultat en cas d'erreur :

Constante

Valeur

Comment

dk status entity does not exist anymore

L'entité n'existe plus dans les données. Cette erreur peut se produire dans les cas suivants :

l'entité a été supprimée (le stamp est modifié et l'espace mémoire est libéré)
l'entité a été supprimée et remplacée par une autre avec une clé primaire différente (le stamp est modifié et une nouvelle entité occupe l'espace mémoire). Avec entity.drop( ), cette erreur peut être retournée lorsque l'option dk force drop if stamp changed est utilisée. Avec entity.lock( ), cette erreur peut être retournée lorsque l'option dk reload if stamp changed est utilisée.

statusText associé : "Entity does not exist anymore"

dk status serious error

Une erreur critique peut être une erreur de bas niveau de la base de données (ex. clé dupliquée), une erreur matérielle, etc.
statusText associé : "Other error"

Exemple

 C_OBJET($employee;$employees;$result)

 

 $employees:=ds.Employee.query("lastName=:1";"Hollis")

 $employee:=$employees[0]

 $employee.firstName:="Mary"

 $result:=$employee.reload()

 Au cas ou

    :($result.success)

       ALERTE("L'entité a été rechargée")

    :($result.status=dk status entity does not exist anymore)

       ALERTE("L'entité est supprimée")

 Fin de cas

Voir aussi

entitySelection[index]