FireDAC.Phys.SQLite.TFDSQLiteCollation
Delphi
TFDSQLiteCollation = class (TFDSQLiteService)
C++
class PASCALIMPLEMENTATION TFDSQLiteCollation : public TFDSQLiteService
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
class | public | FireDAC.Phys.SQLite.pas FireDAC.Phys.SQLite.hpp |
FireDAC.Phys.SQLite | FireDAC.Phys.SQLite |
Beschreibung
Die Klasse, die eine benutzerdefinierte SQLite-Sortierung implementiert.
Mit TFDSQLiteCollation registrieren Sie eine benutzerdefinierte SQLite-Sortierung. Eine registrierte Sortierung kann dann an einer Stelle in einer SQL-Anweisung verwendet werden, wo eine Sortierung angegeben werden darf.
Zum Beispiel:
SELECT * FROM "Employees" ORDER BY LastName COLLATE UTF16NoCase
Jede Sortierung muss über einen in CollationName angegebenen eindeutigen Namen und über eine der drei die als weitere Eigenschaft angegebenen Sortierungsarten verfügen:
- CollationKind = scCompareString. Verwenden Sie zum Konfigurieren der Eigenschaften der Sortierung die Eigenschaften LocaleName und Flags. Abhängig von der Plattform verwendet die Sortierung:
- CompareStringW aus der Win32/Win64-API.
- CFStringCompareWithOptionsAndLocale aus der OS X/iOS-API.
- u_strToUpper, ucol_strcoll aus der Android-LibICU-API.
- CollationKind = scCustomUTF8. Zum Vergleichen von Anwendungsstrings muss der Benutzer das Ereignis OnCompare verwenden, das Strings in der UTF8-Codierung aufnimmt.
- CollationKind = scCustomUTF16. Wie scCustomUTF8, aber Strings werden in UTF16 codiert.
Nach dem Festlegen der Sortierung muss diese mit der Eigenschaft Active aktiviert werden. Um eine Sortierung in einer SQLite-Verbindung zu verwenden, muss die Sortierung vor dem Öffnen der Datenbankverbindung aktiviert werden.