FireDAC.Phys.SQLite.TFDSQLiteCollation
Delphi
TFDSQLiteCollation = class (TFDSQLiteService)
C++
class PASCALIMPLEMENTATION TFDSQLiteCollation : public TFDSQLiteService
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
class | public | FireDAC.Phys.SQLite.pas FireDAC.Phys.SQLite.hpp |
FireDAC.Phys.SQLite | FireDAC.Phys.SQLite |
Description
Classe implémentant un classement SQLite personnalisé.
Utilisez le composant TFDSQLiteCollation pour recenser un classement SQLite personnalisé. Un classement recensé peut ensuite être utilisé en tout emplacement d'une commande SQL susceptible de spécifier un classement.
Par exemple :
SELECT * FROM "Employees" ORDER BY LastName COLLATE UTF16NoCase
Chaque classement doit avoir un nom unique spécifié par CollationName et l'un des trois types de classement spécifiés comme propriétés supplémentaires :
- CollationKind = scCompareString. Pour configurer ses propriétés, utilisez les propriétés LocaleName et Flags. En function de la plate-forme, le classement utilise :
- Win32 / Win64 - API CompareStringW.
- Mac OS X / iOS - API CFStringCompareWithOptionsAndLocale.
- Android - LibICU API u_strToUpper, ucol_strcoll.
- CollationKind = scCustomUTF8. Pour comparer les chaînes d'une application, l'utilisateur doit utiliser l'événement OnCompare, qui reçoit les chaînes au format d'encodage UTF8.
- CollationKind = scCustomUTF16. Similaire à scCustomUTF8, sauf que les chaînes ont le format d'encodage UTF16.
Une fois le classement configuré, il doit être activé en utilisant la propriété Active. Pour utiliser un classement dans une connexion SQLite, l'application doit activer le classement avant d'ouvrir une connexion de base de données.