Data.DB.TParams.ParseSQL

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function ParseSQL(const SQL: string; DoCreate: Boolean): string;

C++

System::UnicodeString __fastcall ParseSQL(const System::UnicodeString SQL, bool DoCreate);

Propriétés

Type Visibilité  Source Unité  Parent
function public
Data.DB.pas
Data.DB.hpp
Data.DB TParams

Description

Recherche les paramètres dans une instruction SQL et les remplace par des points d'interrogation.

Appelez ParseSQL pour remplacer tous les paramètres de l'instruction SQL par des points d'interrogation (?). ParseSQL reconnaît les paramètres par un deux-point les précédant (:). Les deux-points doublés (::) ou les deux-points simples contenus dans des chaînes entre guillemets sont analysés comme littéraux et le nom immédiatement suivant n'est pas remplacé par un point d'interrogation. L'instruction SQL convertie est renvoyée.

Si le paramètre DoCreate a la valeur true, tous les paramètres de la propriété Items sont remplacés par un ensemble d'objets TParam dont les noms sont identiques aux chaînes retirées de l'instruction SQL.

Par exemple, soit la chaîne SQL

SELECT * FROM EMPLOYEES WHERE (ID = :EMP_ID) AND (NAME = :EMP_NAME)

ParseSQL renvoie la chaîne

SELECT * FROM EMPLOYEES WHERE (ID = ?) AND (NAME = ?)

et, si DoCreate a la valeur true, la propriété Items contient deux objets TParam ayant les noms EMP_ID et EMP_NAME.

Voir aussi