UpsKrn.Objet.EcrirePropriete

Procedure EcrirePropriete(NomPropriete : Caractere, Valeur : Nul Ou Objet);

Description

La méthode EcrirePropriete permet de modifier la propriété de nom NomPropriete de l'objet courant. La valeur de la propriété est donnée par le paramètre Valeur. Cette méthode permet de modifier à la fois les propriétés statiques et les propriétés dynamiques de l'objet. Si la propriété statique n'est pas un objet mais un entier, un réel ou un énuméré, alors la valeur est extraite de l'objet NomPropriete.

Si le paramètre NomPropriete identifie une propriété statique, le type de la valeur doit être en accord avec le type déclaré de la propriété statique, sinon l'exception ConvertirImpossible est envoyée.

Si le paramètre NomPropriete identifie une propriété statique qui est en lecture seule, la modification est impossible et l'exception ProprieteEnLectureSeule est envoyée.

Si la propriété n'existe pas, il s'agit de la création d'une propriété dynamique (une propriété dynamique ne peut donc pas porter le même nom qu'une propriété statique). Il faut toutefois que le type de l'objet courant supporte les propriétés dynamiques, sinon l'exception ProprieteDynamiqueImpossible est envoyée.

Exemple

Type Personne Defaut ProprietesDynamiques
/***************************************/
Fin Type

Variable
/******/

Principal
/*******/
Debut
...
/* Ajout de la propriété 'Yeux' de valeur 'Bleu'. */
P.EcrirePropriete("Yeux", "Bleu");
/* Ajout de la propriété 'DateCreation' dont la valeur est la date du jour. */
P.EcrirePropriete("DateCreation", DateSysteme());
/* Modification de la propriété 'NomPersonne' avec la valeur 'Jean-Pierre'. */ P.EcrirePropriete("NomPersonne", "Jean-Pierre");
...
Fin Principal

Voir aussi

LirePropriete pour lire la valeur d'une propriété. SupprimerPropriete pour supprimer une propriété.

Traduction

---------