UpsQry.IRequeteSql.DeclarerParametre


Procedure DeclarerParametre(NomParametre : Caractere, T : Nul Ou Type, TailleMax : Entier=0);

Description

La méthode DeclarerParametre permet de déclarer le paramètre de nom NomParametre de type T de la requête Sql courant.

Les seuls types supportés sont :

Pour les types Binaire et Caractere, il existe deux possibilités :

Données courtes.
Par exemple, une dénomination ou un certificat de sécurité.
En ce cas, elles sont transmises ou produites directement du fait de leur faible encombrement.
Pour les données courtes, la taille maximale admise est précisée par une constante entière positive dans le paramètre TailleMax.
Elle correspond à un nombre d'octets pour le type Binaire et à un nombre de caractères Unicode pour le type Caractere.
A défaut, la taille précisée par le paramètre UpsQry.TailleMax est utilisée.
Données longues.
Par exemple, un texte saisi au kilomètre ou une image.
En ce cas, elles sont transmises ou produites indirectement via des flux du fait de leur fort encombrement.
Pour les données longues, la pseudo-taille est précisée par la constante TailleObjetSqlLong.

La limite de taille entre données courtes et données longues est laissée à la discrétion du programmeur, sachant que le principe du Bulk Processing n'est pas possible avec des paramètres de données longues.

La gestion des données courtes ou des données longues est effectuée automatiquement par Up ! Virtual Technical Machine.

Pour les types de données Date, Entier, Enumere et Reel, la valeur du paramètre TailleMax est ignorée.

Les paramètres du source de la requête Sql sont identifiés par des pseudo-variables. Ils doivent tous être déclarés explicitement par l'appel à cette méthode.

Si la méthode échoue, alors l'exception ErreurOrdreSql est envoyée.

Exemple


Principal

/*******/

Variable

/******/


   MaConnexionSql : Nul Ou ConnexionOracle;

   MaRequeteSql : Nul Ou IRequeteSql;

   MonResultatSql : Nul Ou ResultatRequeteSql;

   Enregistrement : Nul Ou EnregistrementSql;

   NomEmploye : Nul Ou Caractere;

   DateEmbauche : Nul Ou Date;

   NumeroEmploye : Nul Ou Entier;

   Salaire : Nul Ou Reel;



Debut

...

MonOrdreSql=MaConnexionSql.CreerRequeteSql("SELECT ename:=${NomEmploye}, hiredate:=${DateEmbauche}, empno:=${NumeroEmploye}, sal:=${Salaire} FROM emp WHERE deptno=${NumeroDepartement};", 5);

MonOrdreSql.DeclarerParametre("NumeroDepartement", Entier);

MonOrdreSql.DeclarerResultat("NomEmploye", Caractere, 20);

MonOrdreSql.DeclarerResultat("DateEmbauche", Date);

MonOrdreSql.DeclarerResultat("NumeroEmploye", Entier);

MonOrdreSql.DeclarerResultat("Salaire", Reel);

MonOrdreSql.PreparerSql();

MonOrdreSql.EcrireParametre("NumeroDepartement", 10);

MonOrdreSql.ExecuterSql();

MonResultatSql=MonOrdreSql.LireResultatRequete();

Pour Enregistrement=MonResultatSql.ParcoursAuDebut() JusquA MonResultatSql.DernierElement() Faire

   Enregistrement.LireResultat("NomEmploye", NomEmploye);

   Enregistrement.LireResultat("DateEmbauche", DateEmbauche);

   Enregistrement.LireResultat("NumeroEmploye", NumeroEmploye);

   Enregistrement.LireResultat("Salaire", Salaire);

   Ecran.Ecrire(NomEmploye+" "+Caractere(DateEmbauche)+" "+Caractere(NumeroEmploye)+" "+Caractere(Salaire));

Fin Pour

...

Fin Principal

Voir aussi

DeclarerResultat pour déclarer un résultat d'une requête Sql.

Traduction


-	-	-	-	-	-	-	-	-