dotConnect for SQLite Frequently Asked Questions

The free Standard Edition represents a fully-featured ADO.NET data provider with design time support and advanced classes. The Professional Edition adds more classes, tools, technologies, and integration capabilities. The following list briefly enumerates main advantages of Professional Edition.

• Entity Framework support allows you to employ the latest conceptual technology from Microsoft.
• The LinqConnect support allows you to focus on objects instead of relational data in database application development.
• The SQLiteDump class serves to store a database or its parts as a script and to restore database from the generated script.
• The DataLink class serves for universal cross-form data binding.
• The powerful SQLiteDataTable component as all-in-one table data access solution.
• The SQLiteDataSet class allows using typed and untyped provider-specific datasets.
• DataSet Wizard greatly simplifies process of generating datasets in your application.
• DataSet Manager and DataSet Editor help managing the datasets.
• Support for dbMonitor that performs per-component tracing of database events such as SQL statement execution, commit, rollback, etc.
• Enterprise Library support allows you to take advantage of Data Access Application Block functionality.
• ASP.NET providers support allows using the data provider in ASP.NET 2.0 provider model.
• Sync Framework support allows using dotConnect for SQLite for synchronizing SQLite data with other data sources.

To test this functionality use the Trial Edition, which incorporates all aforementioned features.

Make sure you had uninstalled the trial version correctly. There should be no old (trial) assemblies present in your system. Uninstall dotConnect for SQLite and check your Global Assembly Cache and local folders for Devart.* assemblies. Remove all Devart.* files and reinstall dotConnect for SQLite.

Close all running IDEs and help collections, then run the installation package of the newer version. You will be prompted to uninstall the previous version; agree and then proceed to installing the newer build.

Probably you installed dotConnect for SQLite not in typical mode. Please choose typical when installing dotConnect for SQLite. All samples are installed by default in \Program Files\Devart\dotConnect\SQLite\Samples folder.

Yes, there are some. First, the provider add-in (and hence menu item) is not available. Second, components are not registered in toolbox automatically (though you can do it manually). Finally, advanced Visual Studio integration (DDEX) is not available, except Microsoft Web Developer Express 2008 and 2010.

To deploy an application written with dotConnect for SQLite, you need to:

• deploy the Devart runtime assemblies used by your application;
• include the technical license resource;
• in case your application uses provider factories, you also need to expose dotConnect for SQLite to the system.

For the detailed description of each of these steps, please refer to the Deployment and Licensing topics in dotConnect for SQLite help.

Select the "Minimal" type when asked by the installer.

In this release there were some important name changes in the product. Particularly, assemblies, namespaces, invariant name, and some types were changed as follows:
"CoreLab.Data" became "Devart.Data";
"CoreLab.SQLite" became "Devart.Data.SQLite";
"SQLiteDirectFactory" became "SQLiteProviderFactory";
Invariant name became "Devart.Data.SQLite";

Your projects must be updated to be compatible with dotConnect for SQLite 2.0. Here is the list of files you should update:
*.csproj, *.vbproj - references to assemblies
*.cs, *.vb - namespaces
*.licx - namespaces and assembly names
Web.config - assembly names and web provider types

This is done automatically when you invoke the Upgrade wizard from Visual Studio menu: Tools | SQLite | Upgrade Wizard.

Devart data providers use a common assembly (Devart.Data.dll), so it is necessary to install compatible providers versions. We release our ADO.NET data providers in a single pack, thus releases from the same date should be compatible. Also, Devart data providers should warn you before installation if an incompatible version of Devart.Data.dll was detected.

Maybe the sqlite3.dll file is missing. You should make sure your system has acces to this file by checking if it is available in the folder with the database or in the \WINDOWS\system32\ folder.

sqlite3.dll included with the dotConnect to SQLite is compiled with SQLITE_ENABLE_COLUMN_METADATA defined. It allows using sqlite3_column_database_name, sqlite3_column_table_name, and sqlite3_column_origin_name functions, which are necessary for building correct DML statements for a result set with aliases used. If you want to use SQLite from its official website, you need to download its sources and compile it with SQLITE_ENABLE_COLUMN_METADATA defined.

You should put the Devart.Data, Devart.Data.SQLite, and Devart.Data.SQLite.Entity.EF<Version> assemblies in the Bin folder of your application (or place these assemblies in Global Assembly Cache). The <Version> here is the version of Entity Framework used in your application. For Entity Framework v1 the assembly is called Devart.Data.SQLite.Entity.EF1.dll, for Entity Framework v4 and v5 it is Devart.Data.SQLite.Entity.EF4.dll, for Entity Framework v6 it is Devart.Data.SQLite.Entity.EF6.dll. For Entity Framework Core it is Devart.Data.SQLite.Entity.EFCore.dll. Make sure that your application is licensed correctly (take a look at the Licensing article for more information).

Please note that there are three versions of Devart.Data.SQLite.Entity.EFCore.dll assemblies for different Entity Framework Core versions - 1.1, 2.2, and 3.1. They are located respectively in \Entity\EFCore, \Entity\EFCore2, and \Entity\EFCore3 subfolders of the dotConnect for SQLite installation folder.

Information about provider registering is available in the Deployment article.

The dotConnect for SQLite Subscription Program is an annual maintenance and support service for dotConnect for SQLite users.

Users with a valid dotConnect for SQLite Subscription get the following benefits:

• Access to new versions of dotConnect for SQLite when they are released
• Access to all dotConnect for SQLite updates and bug fixes
• Product support through the dotConnect for SQLite Priority Support program
• Notification of new product versions

Priority Support is an advanced product support program which offers you expedited individual assistance with dotConnect for SQLite-related questions from the dotConnect for SQLite developers themselves. Priority Support is carried out over email and has a two business day response policy.

Yes, you can. dotConnect for SQLite version licenses are perpetual.

No, you don't. Provided that you have an active subscription, you will be able to download dotConnect for SQLite 5 from Customer Portal.

dotConnect for SQLite uses .NET component licensing. To build operational application dotConnect for SQLite requires valid license. If no license is available, dotConnect for SQLite does not work.

Usually you do not have to care about embedding license in your application. When you install dotConnect for SQLite the system is configured so that licensing is done transparently. License is automatically added to project when you place a SQLiteConnection component onto a form.
In some cases you have to manually add license. It is necessary for console applications, class libraries, and some ASP.NET applications. For instructions on how to add license manually refer to Licensing topic in dotConnect for SQLite help.

This generally indicates that license information could not be found, or you try to apply it in some way that does not suit the kind of application. For example:

• File licenses.licx, required for dotConnect for SQLite to function properly, could not be found.
• File licenses.licx is not added as embedded resource.
• File App_Licenses.dll not found in ASP.NET applications.

To fix the problem determine type of your application and read corresponding section of "Licensing" topic.

This means that license information was found but it is incorrect. It usually happens in the following cases:

1. The project was earlier compiled with old or trial version of dotConnect for SQLite.
2. File licenses.config used by a class library does not refer to launched executable.
3. The App_Licenses.dll belongs to other application or needs to be recompiled.
4. Something's wrong with the operating system or installation of dotConnect for SQLite.

If you encounter one of these problems, do the following (the numbers of actions correspond to the numbers of the problems in the above list):

1. Delete all files from the bin and obj folders and rebuild the project.
2. Specify the executable in the licenses.config file.
3. Rebuild App_Licenses.dll for the current application.
4. Perform the following steps:
   1. uninstall dotConnect for SQLite;
   2. remove all Devart.* and policy.*.Devart.* files from the GAC;
   3. clear the Program Files\Devart\dotConnect and Program Files\Common Files\Devart\dotConnect folders;
   4. re-install dotConnect for SQLite.

Probably you compiled the application with Trial edition of dotConnect for SQLite, and deployed it with assemblies from non-trial version. In this case time limit is actual as well. To eliminate the problem just recompile the project.

To support server-side compilation you ought to have special assembly App_Licenses.dll in the Bin directory of your site. To create this assembly execute Build Runtime Licenses command in the licenses.licx file context menu in the Solution Explorer view. Required assembly will be created automatically.

Note that this is not necessary for precompiled ASP.NET applications (if nothing is compiled on server by user request). Precompiled applications are licensed as usual applications.

To do this install dotConnect for SQLite on same computer where SQL Server 2008 resides.

If any problems with licensing occurred in your project, you should use the License Information dialog to resolve them. You can access it from the Visual Studio menu: Tools | SQLite | License Information.

No, end-users of your application do not require any license.

No, it is not. This is Connection Pooling feature. Actual connection is not closed in order to be used later by your application. This boosts performance greatly.

The full text of the exception is "Timeout expired. The timeout period elapsed prior to obtaining a connection from the pool. This may have occurred because all pooled connections were in use and max pool size was reached." It clearly states that you have run out of connections available. To solve the problem increase Max Pool Sizeconnection string parameter value. The default value is 100. Another way to get extra connections is to clear one or all of the pools. Or you can turn connection pooling off using Pooling connection string parameter.

You can clear the pool explicitly. Generally pool is cleared automatically when connections are idle or closed by the server. To force the operation call ClearPool or ClearAllPools methods. Another solution is to disable the pool at all (set Pooling=false in connection string). If this does not help, the problem is not caused by pooling.

There are several ways to open dotConnect for SQLite documentation:

• Use appropriate shortcut in start menu, for instance, Start - Programs - Devart dotConnect for SQLite - Documentation .
• Use command in the IDE: Tools - SQLite - dotConnect for SQLite Help.
• Position cursor on some class from Devart.Data.SQLite and press F1.

There is also same documentation in chm format. You can download it from our site at the following address: www.devart.com/dotconnect/sqlite/dcsqlite.chm

Correctly installed documentation appears as separate node in combined collection of Visual Studio and Delphi. If you can't find dotConnect for SQLite node there it is because you enabled topics filtering. To reveal the node set filter to "Devart Documentation", or "(unfiltered)", or "Visual C#" etc.

Another possible reason is that you installed some IDE after installation of dotConnect for SQLite. In this case use aforementioned methods to reach documentation.

This can happen due to some patches from Microsoft installed on your system. Please read this page to find possible solutions for the problem. In most cases it is enough to right-click on the CHM file, select Properties, click on the "Unblock" button and click "Apply" to show the contents.

The Professional Edition of dotConnect for SQLite supports both LinqConnect (formerly called LINQ to SQLite) and the latest version of ADO.NET Entity Framework.

For your convenience there are brief tutorials that you can use to get acquainted with the technologies:

• Entity Framework Tutorial
• LinqConnect Tutorial

Yes, dotConnect for SQLite includes several Entity Framework and LinqConnect samples in C# and Visual Basic. The samples demonstrate how to use several entities and a relationship between them. You can also download separate Entity Framework Query Samples package, which is a standard Microsoft demo with added SQLite connectivity.

This can happen when SQLiteCommandBuilder generates a query without primary key field. To avoid it use custom update command instead of generated by SQLiteCommandBuilder. This problem should not take place if primary key field participates in SELECT statement.

This can happen if the installation encountered some problems. You can add the components to toolbox manually. This procedure is described in the Installation article in the documentation. Note that Microsoft Web Developer 2008 Express edition does not allow working with toolbox at all.

Make sure you're in Component Designer view. Do not confuse with Designer view. To switch between views use context menu of .aspx file in Solution Explorer. This relates to Web projects only.

This is an architecture limitation from Microsoft, SSIS understands metadata of SQL Server only. To circumvent this you have to write queries manually.

dotConnect for SQLite assemblies are built with the /platform:anycpu option. So, you can use provider's assemblies on any platform (x86 or x64). For more information, refer to https://msdn.microsoft.com/en-us/library/zekwfyz4.aspx

However, you need to ensure that you are using the compatible version of the engine library sqlite3.dll. The engine library version of the proper capacity is deployed during installation of dotConnect for SQLite depending on the target machine capacitity (e.g., the 64-bit version is deployed onto 64-bit machines).