Product/license key

1. What is it?

The product (license) key is a kind of a digital key that stores information about your license for EasyQuery and allows you to unlock all the features of this library that are not available in the trial version.

Please note that the license key works within one minor version of EasyQuery. For example, the key created for version 6.0.0 will be valid for versions 6.0.1 or 6.0.5, but will not work with version 6.1.0.

Therefore, when updating the version of EasyQuery packages used in your project, please remember to replace the keys in your program (where exactly is described in the 3rd section).

NB: The product key is used only in version 4.0 or higher

If you are still using version 3.x, you need to download full version of the library and replace the assemblies from the trial version used in your project with their "full" versions.

2. How to get the key?

  • Log in to your account on Korzh.com website using your email address as a username and the password you got after the registration. If you don't remember the password - please use Forgot Your Password? link on the login form

  • Go to the "License Details" page for your EasyQuery license.

  • Click the "Get Key" button for the version you need

If there is no the version you need in the list - it means that your software maintenance subscription has expired already and you need to renew it. You can do it on the same page by clicking on the "Renew Subscription" link.

3. How to use?

To use the license key, you just need to assign them to the special static global variables somewhere at the beginning of your program (before the first usage of any EasyQuery class).

The actual place where to place the keys depends on the project's type.

ASP.NET Core

ASP.NET Core edition (as well as ASP.NET) of EasyQuery requires two keys, one for the server-side EasyQuery packages, second - for EasyQuery.JS scripts.

The best place for both of them is appsettings.json config file:

{
  .   .   .   .
  "EasyQuery": {
    "LicenseKey": "Your license key for EasyQuery ASP.NET Core",
	"JSLicenseKey": "Your license key for EasyQuery.JS"
  }
}

NB: If you set the keys via global static variables in your code (like Korzh.EasyQuery.AspNetCore.License.Key = "...") you will need to replace them there instead of placing in a config file. In any case, it's better not to mix these two methods.

ASP.NET

The best place to set the keys in ASP.NET 4 web-app is Application_Start method in Global.asax.cs file:

        protected void Application_Start()
        {
		    .    .    .    .    .

            Korzh.EasyQuery.AspNet.License.Key = "Your license key for EasyQuery ASP.NET";
            Korzh.EasyQuery.AspNet.JSLicense.Key = "Your license key for EasyQuery.JS";
        }

WPF

For WPF projects the key can be set anywhere before the first usage of EasyQuery classes. For example, in a constructor of the main form:

        public MainWindow()
        {
            Korzh.EasyQuery.Wpf.License.Key = "Your license key for EasyQuery WPF";

            .   .    .    .
        }

Windows Forms

The same as for WPF projects the key can be set anywhere before the first usage of EasyQuery classes.

        public MainForm()
        {
            Korzh.EasyQuery.WinForms.License.Key = "Your license key for EasyQuery WinForms";

            .   .    .    .
        }