QuickScript ​.NET variables

Déclarez les variables pour QuickScript .NET avant qu'elles puissent être utilisées dans des scripts pour QuickScript .NET. Ces variables sont utilisable aussi bien en termes gauche et droit des instructions et des expressions.

Les variables locales ou les attributs sont utilisables ensemble dans le même script. Les variables déclarées dans le corps du script perdent leur valeur après l'exécution. Celles déclarées dans le corps du script ne sont pas visibles depuis d'autres scripts.

Les variables déclarées dans la zone Déclarations conservent leurs valeurs pendant la durée de vie de l'objet avec lequel le script est associé.

Déclarez chaque variable dans le script par une instruction DIM séparée, suivie d'un point-virgule. Saisissez les instructions DIM dans la zone Déclarations de l'onglet Script. La syntaxe de l'instruction DIM est la suivante :

DIM <nom_variable> [ ( <limite_sup>
[, <limite_sup >[, < limite_sup >]] ) ]
[ AS <type_données> ];

Où :

À la différence des noms d'attributs, les noms de variables ne doivent pas contenir de point. Les identifiants de noms de variables et de type de données ne sont pas sensibles à la casse. En cas de conflit de nommage entre une variable déclarée et une autre entité nommée dans le script (un nom d'attribut, un alias ou un nom d'objet exploités dans le script, par exemple), le nom de variable est prioritaire sur les autres entités nommées. Si un nom de variable est le même qu'un nom d'un alias, un message d'avertissement est affiché lors de la validation du script pour signaler que l'alias est ignoré.

La syntaxe pour spécifier la matrice entière est « [ ] » aussi bien pour des variables matricielles locales que pour des références d'attributs. Par exemple, pour attribuer une matrice d'attribut à une matrice locale, la syntaxe est :

locarr[] = tag.attr[];

Les instructions DIM peuvent se trouver n'importe où dans le corps du script, mais doivent précéder la première instruction ou expression qui y fait référence dans le script. Si une variable locale est référencée avant une instruction DIM, la validation du script vous invitera à la définir lors de l'enregistrement de l'objet contenant le script.

La validation mentionnée ci-dessus ne se produit qu'au moment d'enregistrer l'objet contenant le script. Ce n’est pas la validation syntaxique du script qui est faite en cliquant sur le bouton Valider le script.

Les instructions DIM en cascade ne sont pas admises. Les exemples suivants ne sont pas valides :

DIM VarLoc1 AS Integer, VarLoc2 AS Real;

DIM VarLoc3, LocVar4, LocVar5, AS Message;

Pour déclarer plusieurs variables, entrez une instruction DIM différente pour chacune d'elles.

Les variables locales déclarées, quand elles s'utilisent en terme droit d'une équation, définissent toujours l'expression en terme gauche comme de qualité bonne. Par exemple :

dim x as integer;

dim y as integer;

x = 5;

y = 5;

me.attr = 5;

me.attr = x;

me.attr = x+y;

À chaque fois, me.attr reçoit une qualité bonne.

Quand une variable est utilisée à droite d'un opérateur, sa qualité est considérée bonne pour permettre la propagation de qualité des données.

Il est possible d'utiliser null pour indiquer qu'aucun objet n'est attribué à une variable. L'usage de null a ici la même signification que mot-cké « null » en C# ou que « nothing » en Visual Basic. Un variable définie à null rend la variable éligible au nettoyage de la mémoire. Il n'est pas possible d'utiliser une variable dont la valeur est null. Dans ce cas, le script s'arrête et un message d'erreur est consigné dans le journal. En revanche, il est possible de tester si une variable vaut null. Par exemple :

IF maVariable == null THEN …

Il n'est pas possible des passer des attributs comme paramètres à des objets du système. Pour contourner cette restriction, utilisez une variable locale intermédiaire ou convertissez explicitement l'attribut en chaîne avec la fonction appropriée lorsque vous invoquez l'objet du système.