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
La classe implémentant un classement SQLite personnalisé.
Utilisez TFDSQLiteCollation pour recenser un classement SQLite personnalisé. Un classement recensé peut ensuite être utilisé à tout endroit d'une commande SQL dans lequel un classement peut être spécifié.
Par exemple :
SELECT * FROM "Employees" ORDER BY LastName COLLATE UTF16NoCase
Chaque classement doit avoir un nom unique spécifié par CollationName et un des trois types de classement spécifié comme propriété supplémentaire :
- CollationKind = scCompareString. Pour configurer ses propriétés, utilisez les propriétés LocaleName et Flags. Selon la plate-forme, le classement utilisera :
- Win32 / Win64 - API CompareStringW.
- OS X / iOS - API CFStringCompareWithOptionsAndLocale.
- Android - LibICU API u_strToUpper, ucol_strcoll.
- CollationKind = scCustomUTF8. Pour comparer les chaînes de l'application, l'utilisateur doit utiliser l'événement OnCompare qui recevra des chaînes encodées en UTF8.
- CollationKind = scCustomUTF16. Similaire à scCustomUTF8, sauf que les chaînes sont encodées en UTF16.
Une fois configuré, le classement 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 la connexion de base de données.