Compatibilité du framework dbExpress
Remonter à Développement d'applications de bases de données pour la plate-forme Win32 - Index
Certains logiciels dbExpress développés avant le framework de pilote dbExpress (framework de pilote DBX) ont été modifiés pour fonctionner avec le framework de pilote DBX. A cause de ces modifications, certains problèmes de compatibilité se produisent.
Général
Les pilotes dbExpress 2.5 ne peuvent pas être utilisés avec le framework DBX.
Le framework dbExpress n'offre pas une compatibilité à 100% avec dbExpress 3.
Les pilotes dbExpress 3 peuvent être utilisés avec le framework DBX. Le chargeur du framework de pilote DBX détecte automatiquement les pilotes dbExpress 3 et utilise le pilote DBXAdapter (dbxadapter30.dll) afin qu'un pilote dbExpress 3 ressemble à un pilote dbExpress 4.
Voici la liste des problèmes de compatibilité connus :
- Liaison de pilotes statique. Vous ne pouvez pas lier de façon statique des pilotes dbExpress dans un exécutable.
- SqlExpr.TSQLConnection fournissait un accès protégé au membre Connection qui était de type TISQLConnection seulement dans la version native de SqlExpr.pas. Cela a été omis dans la version managée en raison de la complexité de l'utilisation de PInvoke dans la version managée de la VCL dbExpress. SqlExpr.TSQLConnection fournit maintenant à la place un accès protégé à un Data.DBXCommon.TDBXConnection. Cette connexion protégée est accessible aux applications natives et managées.
- L'événement du contrôle des traces est légèrement différent car il est basé sur le framework de pilote DBX.
- Le pilote DBXadapter peut adapter les pilotes dbExpress 3 à dbExpress 4, mais pas les pilotes dbExpress 2.5.
Problèmes VCL
La plupart des applications utilisant des composants VCL dbExpress devraient fonctionner sans modification. Toutefois, des modifications localisées sont apportées aux composants VCL en raison de la VCL s'interfaçant maintenant sur le framework de pilote DBX orienté objet au lieu de l'interface de pilote dbExpress 3 basée sur COM C-like.
En outre, l'API a été légèrement modifiée pour les deux composants VCL suivants : Data.SqlExpr.TSQLConnection et Data.SqlExpr.TSQLDataSet. Certaines structures de données ont également été modifiées. Vous trouverez ci-après un résumé des changements de l'API.
Remarque : A cause des modifications apportées à l'API, vous devez recompiler SqlExpr.pas qui est livré avec le produit. L'unité DBXpress a été dépréciée.
- TSQLConnection. La méthode Commit a été dépréciée en faveur de la nouvelle méthode CommitFreeAndNil. La méthode Rollback a été dépréciée en faveur des nouvelles méthodes RollbackFreeAndNil et RollbackIncompleteFreeAndNil. La méthode SetTraceCallbackEvent a été remplacée par SetTraceEvent. La méthode StartTransaction a été dépréciée en faveur de la nouvelle méthode BeginTransaction. La propriété MetaData contient une instance de la nouvelle classe Data.DBXCommon.TDBXDatabaseMetaData au lieu de TISQLMetaData. La propriété SQLConnection a été remplacée par DBXConnection, qui contient une instance de la nouvelle classe Data.DBXCommon.TDBXConnection. La propriété TraceCallbackEvent contient maintenant un TDBXTraceEvent.
- TSQLDataSet. La nouvelle propriété DbxCommandType a été ajoutée. Elle contient une des chaînes constante de la classe Data.DBXCommon.TDBXCommandTypes.
- Structures de données. TTransactionItem a été dépréciée et remplacée par la nouvelle classe Data.DBXCommon.TDBXTransaction. TSQLDriverOption, TSQLConnectionOption, TSQLCommandOption, TSQLCursorOption, TSQLMetaDataOption et TSQLObjectType sont obsolètes. TSTMTParamType a été remplacée par la classe Data.DBXCommon.TDBXParameterDirections. TSQLTraceFlag a été remplacée par Data.DBXCommon.TDBXTraceFlags. SQLTRACEDesc a été remplacée par TDBXTraceInfo.