Section SQL du fichier de personnalisation

S’applique à : Access 2013, Office 2013

La section sql peut contenir une nouvelle chaîne SQL qui remplace la chaîne de commande cliente. Si aucune chaîne SQL ne figure dans la section, celle-ci est ignorée.

La nouvelle chaîne SQL peut être paramétrable. Autrement dit, les paramètres de la chaîne SQL de la section sql (désigné par le caractère « ? ») peuvent être remplacés par les arguments correspondants dans un identificateur dans la chaîne de commande cliente (désigné par une liste délimitée par des virgules entre parenthèses). L'identificateur et la liste des arguments ont un comportement similaire à celui d'un appel de fonction.

Par exemple, supposons que la chaîne de commande cliente est « CustomerByID(4) », que l’en-tête de section SQL est [SQL CustomerByID] et que la nouvelle chaîne de section SQL est « SELECT * FROM Customers WHERE CustomerID = ? ». Le gestionnaire génère , l’en-tête de section SQL est [SQL CustomerByID] et la nouvelle chaîne de section SQL est « SELECT * FROM Customers WHERE CustomerID = ? ». Le gestionnaire génère « SELECT * FROM Customers WHERE CustomerID = 4 » et utilise cette chaîne pour interroger la source de données.

Si la nouvelle instruction SQL est une chaîne vide (""), la section est ignorée.

Si la chaîne de la nouvelle instruction SQL n'est pas valide, l'exécution de l'instruction échoue. Le paramètre client est ignoré. Vous pouvez avoir recours à cette programmation intentionnellement pour « désactiver » toutes les commandes SQL clientes en spécifiant :

 
[SQL default] 
SQL = " " 

Syntaxe

Une chaîne d'entrée SQL de remplacement a la forme suivante :

SQL=sqlString

Élément	Description
SQL	Chaîne littérale qui indique qu'il s'agit d'une entrée de section SQL.
sqlString	Chaîne SQL qui remplace la chaîne cliente.