[]
This topic describes how ComponentOne licensing is applied to modern .NET applications, including .NET Core, ASP.NET Core, WinForms, WPF, Blazor, MAUI, and WinUI.
For other application types and scenarios, see Licensing Applications.
ComponentOne controls support application licensing through NuGet package build scripts and supporting licensing tools.
Each developer machine or build machine that builds the application must have an activated serial key. Licensing is applied automatically during the build process.
For instructions on activating a serial key, see Activating a Serial Key.
When an application is built on a properly activated machine:
A runtime license file (.sa3licx) is generated automatically during the build.
The license file is embedded in the application as an embedded resource.
For modern .NET applications, the generated runtime license file uses the .sa3licx format.
In some mixed or compatibility scenarios, a legacy runtime license file (.gclicx) may also be generated.
Before embedding, the license file can typically be found in the build output directory, for example:
obj/Debug
obj/Release
The embedded runtime license file must be included when the application is distributed.
Notes
Application Binding
The runtime license file is application-specific. The application name embedded in the license must match the project in which it was built.
If you need to license a component for use in a differently named application (for example, when building a user control or class library), see Licensing User Controls.
Development Environment Requirements
NuGet-based licensing and automatic license generation are supported in Visual Studio 2019 and later.
For older versions of Visual Studio or .NET Frameworkâspecific scenarios, see Licensing .NET Framework Applications.