Section SQL du fichier de personnalisation

La section sql peut contenir une nouvelle chaîne SQL qui remplace la chaîne de commande cliente. S’il n’existe aucune chaîne SQL dans la section, la section est ignorée.

Important

À compter de Windows 8 et Windows Server 2012, les composants serveur RDS ne sont plus inclus dans le système d’exploitation Windows (voir Windows 8 et livre de recettes de compatibilité Windows Server 2012 pour plus de détails). Les composants clients RDS seront supprimés dans une prochaine version de Windows. Évitez d’utiliser cette fonctionnalité dans le nouveau travail de développement et prévoyez de modifier les applications qui utilisent actuellement cette fonctionnalité. Les applications qui utilisent RDS doivent migrer vers WCF Data Service.

La nouvelle chaîne SQL peut être paramétrable. Autrement dit, les paramètres de la chaîne SQL de section sql (désignés par le caractère « ? ») peuvent être remplacés par des arguments correspondants dans un identificateur dans la chaîne de commande cliente (désignée par une liste délimitée par des virgules entre parenthèses). L’identificateur et la liste d’arguments se comportent comme 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 "SELECT * FROM Customers WHERE CustomerID = 4" et utilise cette chaîne pour interroger la source de données.

Si la nouvelle instruction SQL est la chaîne Null («  »), la section est ignorée.

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

[SQL default]   
SQL = " "  

Syntaxe

Une entrée de chaîne SQL de remplacement se présente sous la forme suivante :

SQL=
sqlString

Partie	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.

Voir aussi

Section de connexion des fichiers de personnalisation
Section journaux de personnalisation des fichiers
section UserList de fichier de personnalisation
Personnalisation de DataFactory
paramètres client requis
Comprendre le fichier de personnalisation
Écrire Votre Propre Gestionnaire Personnalisé