This topic provides technical details on licensing of .NET Standard (.NET Core) projects, using dotConnect for MySQL. For licensing on Full .NET Framework see the Licensing topic.
Unlike on full .NET Framework, on dotConnect for MySQL uses license keys on .NET Core. For registered version, the dotConnect for MySQL license key is specified at runtime, in the License Key connection string parameter. For trial version, license key files are used instead. They are generated by the product installer and placed to the C:\ProgramData\Devart\dotConnect\License\ folder.
Here is an example of specifying a license key parameter in a connection string:
Trial license key files are automatically generated when installing dotConnect for MySQL on the computer. This means that even though .NET Standard compatible assemblies are obtained via NuGet packages, you still need to download and install dotConnect for MySQL trial from Devart website to generate the trial license keys.
dotConnect for MySQL Trial checks license as a file in the C:\ProgramData\Devart\dotConnect\License\ folder. dotConnect for MySQL Trial installation automatically adds the license files to this folder. When deploying your project to another computer, you need to deploy the correspondung license key file to this folder.
The license key file of the trial version is named Devart.Data.MySql.key.
On Linux, there is no C:\ProgramData\ folder. You can copy the trial license key to another folder (for example, to the folder of the application itself) and specify its path in the License Key connection string parameter in the following way:
license key=trial:/home/test/Devart.Data.MySql.key
Please note that on Linux the path to the key file is case sensitive and must be specified exactly in the same case as it is in your file system.
After you purchased dotConnect for MySQL, you will get an email with the activation key. You can also view your key in the Devart Account, where you download your licensed product installers.
You must specify this activation key in the License Key connection string parameter.
You don't need to specify your license key in every connection string. Once a connection with a valid License Key is successfully opened, there will be no further license check in a current application domain. So, you can load your license key from somewhere (from embedded resource, etc.), open a test connection, and after this your application can work with connection strings without License Key.
The Professional and Developer editions of dotConnect for MySQL include LinqConnect functionality. Thus, you don't need any additional actions and can use LinqConnect features with the dotConnect for MySQL key as described above. The same is applicable to the dotConnect for MySQL trial.
However, if you have dotConnect for MySQL Standard Edition and a separate LinqConnect product, and want to use feaures of both of them in your project, you will need to use both your LinqConnect key and your dotConnect for MySQL key. You can specify both license keys, separating them by comma, in the License Key connection string parameter.
Keys, specified in the connection string has priority over the key files, placed to the C:\ProgramData\Devart\dotConnect\License\ folder.
Licensed keys has priority over trial keys.
If you use a key for the Standard edition of dotConnect for MySQL, a key file for LinqConnect trial will be searched and checked, and if a valid one is found, LinqConnect features will be available.
License information is loaded once and has effect over all of the provider instances in the application domain. However, if a key is loaded from file from the C:\ProgramData\Devart\dotConnect\License\ folder is loaded first, the first opening of a connection with the License Key connection string parameter overrides the license information, loaded from the file.