Starting with 2020 v2, released July 29th 2020, app keys are no longer required when referencing ComponentOne NuGet packages and using Visual Studio 2019 and newer. See more information in our licensing documentation.

If you are using a version prior to 2020 v2, or Visual Studio 2017, you will need to generate an app key described below. Or, if you have an existing app and would like to update it to use version 2020 v2 or later, your app key will continue to work.

Some ComponentOne products implement runtime licensing, which means controls require a unique key to be validated at runtime. The process is quick, requires minimal memory, and does not require a network connection.  This page offers an overview of how to license your app, and includes instructions for these platforms:

Evaluation Keys

Evaluation keys are good for 30 days, and should not be distributed with published apps. Each application that uses an app key requires a unique license key, which you can generate in two ways:

Fully Licensed Keys

Fully licensed keys never expire so long as your app uses a version of your product included with your subscription.

You can update apps beyond your subscription end date so long as you continue to use a valid version of UWP Edition.

  • Purchase and register your serial number.
  • Generate a full key using the form above for each app (unlimited).
Xamarin, UWP, and ASP.NET Core MVC and Web API licensing relies on your application name.  Make sure that you set the AppName on the license generator page to the Default Namespace of your application.

How to License Your App

Copy the generated application key and insert it into beginning of your application class constructor.  This will vary by platform.

For Xamarin.Forms:

public partial class App : Xamarin.Forms.Application

{  /// 
  /// Initializes the singleton application object. This is
   /// must be done before the controls are instantiated,
   /// and should be set when you app first starts.
public App()  
      C1.Xamarin.Forms.Core.LicenseManager.Key = "";  

For Xamarin.iOS:
public class AppDelegate : UIApplicationDelegate

public override bool FinishedLaunching(UIApplication application, NSDictionary launchOptions)
      C1.iOS.Core.LicenseManager.Key = "";  

For Xamarin.Android:
public class MainActivity : Activity

protected override void OnCreate()  
      C1.Android.Core.LicenseManager.Key = "";  

Both a LicenseManager.Key set from code and a key generated by the GrapeCity License Manager add-in (GCDTLicenses.xml) are valid, and they work in the same way. You can use the solution that is most convenient for you.

Note: if an application sets the LicenseManager.Key from code, Xamarin Edition will ignore GCDTLicenses.xml file content.

Note: a key generated for Xamarin will also work with our legacy Xuni control suite. You can generate a key using the same app key portal and add it to your app as per the directions found in the Getting Started with Xuni / Licensing sections in the respective product documentation

Click here to get your Xamarin app key

For UWP:

Copy generated application key and insert it into beginning of you application class constructor: sealed partial class App : Application

{  ///   /// Initializes the singleton application object. This is the first line of authored code  /// executed, and as such is the logical equivalent of main() or WinMain().  ///   public App()  {      C1.UWP.LicenseManager.Key = "";  }

Both C1.UWP.LicenseManager.Key set from code and key included into GCDTLicenses.xml file are valid and work in the same way. You can use the one which is more convenient for you.

Note, if application sets C1.UWP.LicenseManager.Key from code, UWP Edition will ignore GCDTLicenses.xml file content.

Click here to get your UWP app key

For ASP.NET Core MVC and Web API Edition:

Add the generated License.cs class to your project and assign the key in the Startup.cs of the Mvc/WebApi for ASP.NET Core project:

public void ConfigureServices(IServiceCollection services)  

{ C1.Web.Mvc.LicenseManager.Key = License.Key; //for Web API use as below //C1.Web.Api.LicenseManager.Key = License.key; services.AddMvc(); }

Click here to get your ASP.NET Core MVC/Web API app key