UpsPls.Travail.LireValeurEnumere

Fonction LireValeurEnumere(NumeroParametre : Entier) Retourner Enumere;

Description

La méthode LireValeurEnumere permet de retrouver la valeur d'un paramètre ou du résultat d'appel correspondant au travail de type énuméré.

Si cette méthode est invoquée avec la valeur 0 pour le paramètre NumeroParametre, alors le résultat de l'appel est demandé. En ce cas, l'appel doit être une fonction ou une méthode fonctionnelle dont le résultat est un énuméré, sinon l'exception OperationParametreImpossible est envoyée.

Si cette méthode est invoquée avec une valeur strictement positive pour le paramètre NumeroParametre, alors la valeur du paramètre de l'appel de ce numéro est demandée. En ce cas, ce paramètre doit exister et doit être un énuméré, sinon l'exception OperationParametreImpossible est envoyée.

Si cette méthode est invoquée avec une valeur strictement négative pour le paramètre NumeroParametre alors l'exception OperationParametreImpossible est envoyée.

Les paramètres d'entrée peuvent être lus avant ou après l'exécution du travail. En ce cas, le résultat est la valeur d'entrée.

Les paramètres d'entrée-sortie peuvent être lus avant l'exécution du travail. En ce cas, le résultat est la valeur d'entrée. Les paramètres d'entrée-sortie peuvent être lus après l'exécution du travail. En ce cas, le résultat est la valeur de sortie.

Les paramètres de sortie peuvent être lus après l'exécution du travail. En ce cas, le résultat est la valeur de sortie.

Avertissement

Les variables, les propriétés ou les éléments de tableau passés en tant que paramètre d'entrée-sortie ou de sortie de l'appel ne sont pas automatiquement alimentés suite à la mise en file du travail. Cela vient du fait que l'exécution de l'appel est asynchrone. Il est donc obligatoire d'employer ces méthodes pour retrouver les valeurs des paramètres.

Exemple

Variable
/******/

FileDAttente
/**********/

/****************************************************************/
Procedure P(A : Booleen Entree Sortie)
/* Objet : Procedure quelconque. */
/****************************************************************/
Debut
Ecran.Ecrire("P="+Caractere(A));
A=Vrai;
Fin Procedure

Principal
/*******/
Debut
...
B=Faux;
MonTravail=P(B)||MaFile;
...
B=MonTravail.LireValeurEnumere(1);
/* Nous retrouvons la valeur du paramètre de sortie. */
...
Fin Principal

Voir aussi

LireValeurEntier, LireValeurReel et LireValeurObjet pour lire les valeurs de paramètres d'autres types.

Traduction

---------