Partage via

Clause APPEND de forme

  • Article

La clause APPEND de la commande shape ajoute une ou plusieurs colonnes à un jeu d'enregistrements . Fréquemment, ces colonnes sont des colonnes de chapitre, qui font référence à un Recordset enfant .

Syntaxe

SHAPE [parent-command [[AS] parent-alias]] APPEND column-list

Description

Les parties de cette clause sont les suivantes :

commande parente de
Zéro ou un des éléments suivants (vous pouvez omettre complètement la commande parente ) :

  • Commande fournisseur placée entre accolades ( »{}« ) qui retourne un objet Recordset. La commande est émise au fournisseur de données sous-jacent, et sa syntaxe dépend des exigences de ce fournisseur. Il s’agit généralement du langage SQL, même si ADO ne nécessite aucun langage de requête particulier.

  • Une autre commande de forme incorporée entre parenthèses.

  • Mot clé TABLE, suivi du nom d’une table dans le fournisseur de données.

parent-alias
Alias facultatif qui fait référence au jeu d’enregistrements parent .

liste de colonnes
Une ou plusieurs des opérations suivantes :

  • Colonne d’agrégation.

  • Colonne calculée.

  • Nouvelle colonne créée à l’aide de la clause NEW.

  • Colonne de chapitre. Une définition de colonne de chapitre est placée entre parenthèses (« () »). Consultez la syntaxe suivante.

SHAPE [parent-command [[AS] parent-alias]]  
   APPEND (child-recordset [ [[AS] child-alias]   
      RELATE parent-column TO child-column | PARAMETER param-number, ... ])  
   [[AS] chapter-alias]   
   [, ... ]

Remarques

jeu d’enregistrements enfants

  • Commande fournisseur placée entre accolades ( »{}« ) qui retourne un objet Recordset. La commande est émise au fournisseur de données sous-jacent, et sa syntaxe dépend des exigences de ce fournisseur. Il s’agit généralement du langage SQL, même si ADO ne nécessite aucun langage de requête particulier.

  • Une autre commande de forme incorporée entre parenthèses.

  • Nom d’un jeu d’enregistrements structuré déjà existant.

  • Mot clé TABLE, suivi du nom d’une table dans le fournisseur de données.

alias enfant
Un alias qui se réfère au Recordset enfant .

colonne parente
Colonne du jeu d’enregistrements rétournée par la commande parente .

colonne enfant
Une colonne dans le jeu d’enregistrements , retournée par la commande enfant .

param-number
Consultez Opération des commandes paramétrées.

alias de chapitre
Un alias qui fait référence à la colonne du chapitre ajoutée au parent.

Note

La clause « parent-column TO child-column » est en fait une liste, où chaque relation définie est séparée par une virgule

Note

La clause après le mot clé APPEND est en fait une liste, où chaque clause est séparée par une virgule et définit une autre colonne à ajouter au parent.

Lorsque vous construisez des commandes de fournisseur à partir d’une entrée utilisateur dans le cadre d’une commande SHAPE, SHAPE traite la commande fournisseur fournie par l’utilisateur comme une chaîne opaque et les transmet fidèlement au fournisseur. Par exemple, dans la commande SHAPE suivante,

SHAPE {select * from t1} APPEND ({select * from t2} RELATE k1 TO k2)

SHAPE exécute deux commandes : select * from t1 et (select * from t2 RELATE k1 TO k2). Si l’utilisateur fournit une commande composée composée de plusieurs commandes de fournisseur séparées par des points-virgules, SHAPE n’est pas en mesure de distinguer la différence. Ainsi, dans la commande SHAPE suivante,

SHAPE {select * from t1; drop table t1} APPEND ({select * from t2} RELATE k1 TO k2)

SHAPE exécute select * from t1; drop table t1 etselect * from t2 RELATE k1 TO k2),, sans se rendre compte que drop table t1 est une commande de fournisseur distincte et dangereuse dans ce cas. Les applications doivent toujours valider l’entrée de l’utilisateur pour empêcher ces attaques potentielles contre les pirates.

Cette section contient les rubriques suivantes.

Voir aussi

exemple de mise en forme des données
grammaire formelle des formes
Commandes de Forme en Général