TSQLDBLibraryLoader

Warning: This article is still a rough draft; please compare with the official announcement by Michael Van Canneyt on the Free Pascal mailing list and update this page.

TSQLDBLibraryLoader is a Lazarus and FPC component that specifies the names and locations of SQLDB database libraries (DLLs/.sos/.dylibs) should be loaded from where. The TSQLDBLibraryLoader component is available on the SQLdb tab of the Component Palette.

Use and alternatives

For SQLDB database connectors, at least recent FPC versions try to load some default library names, but may fail. Using SQLDBLibraryLoader, you can specify the exact filename to load.

SQLDBLibraryLoader needs to be called before loading/enabling TSQLConnection components.

Note that often you can do a similar thing by setting the library name for the TSQLConnection descendant you are using. This does depend on that TSQLConnection descendant supporting that functionality.

Note: Support for using SQlite with SQLDBLibraryLoader was added to FPC trunk (2.7.1) and is not available in earlier FPC versions. Possible alternative: InitializeSQLite function in unit sqlite3dyn. Please remove this text if tested.

Sample code

  SQLDBLibraryLoader1.ConnectionType:='SQLite3';
// Note: .ConnectionType resets the LibraryName, so set LibraryName after
// setting ConnectionType!!
  SQLDBLibraryLoader1.LibraryName := 'c:\path_to_sqllite_library\sqlite3.dll';
  SQLDBLibraryLoader1.Enabled := true; 
  SQLDBLibraryLoader1.LoadLibrary;

See also

• TSQLConnector

From the Free Pascal wiki, page "TSQLDBLibraryLoader", as it stood on 2020-03-02 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's Licensing page. If you have concerns about this material, message the admin.