WPF Controls

How do I license my component?

Xceed admin — Wed, 08 Oct 2008 13:12:29 GMT

.NET PRODUCTS

If you have purchased a registered license key, here is how the licensing process works:

- Receive your registered license key at the email address used during the purchase.

- Set the Licenser.LicenseKey property with this license key. See the LicenseKey property section below for details.

- Compile your application and deploy it.

If you do not have a registered license key, please contact Xceed at 1-800-865-2626, ext. 228, or send an email to sales@xceedsoft.com to purchase a license or to have your license key resent to you if you have lost it.

LicenseKey property

The LicenseKey property of the Licenser class must be set with a valid license key, before any other method of your Xceed component is called. If you use an invalid or expired license key, fail to license the control with a registered license key after the trial period, or license it in the wrong place in your code, an exception will be thrown at runtime.

We recommend that you set the LicenseKey property in the main entry point of the application. For example, C# users can set the LicenseKey property in the static main function. VB.NET users can set the LicenseKey property in the constructor of the main form or in the "Sub Main" procedure.

If no entry point is available, it is recommended that you set the LicenseKey property in a static constructor of a class that will be accessed systematically before any of the library's classes are instantiated or, you can simply set the LicenseKey property immediately BEFORE you instantiate a class.

Special Considerations for Xceed DataGrid for WPF

The LicenseKey property of the Licenser class must be set with a valid Express or Professional Edition license key, before any other method of your Xceed component is called. If you use an invalid license key, expired trial key, or license it in the wrong place in your code, an exception will be thrown at runtime.

It is recommended that the LicenseKey property be set in one of the following locations:

Location	Description
Application.OnStartup method override	Preferred location.
Windows.Loaded or Page.Loaded events	The LicenseKey property can be set in this event as long as the startup page or window is knonw and invariable.

ACTIVEX PRODUCTS

In order for the library to work at runtime, the first thing you must do before calling any of the library's functions is to call the License method and provide it with your trial or registered license key.

Your trial or registered license key can be obtained by running the 'Xceed Component Licenser' application which can be run from the Start Menu by selecting the Program files -> Xceed Components -> Xceed Component Licenser item.

If you have purchased a registered license of the product, you should provide your registered license key to the Xceed Component Licenser in order to replace the automatically generated free trial license key.

xceedProduct.License( "your_license_key" )

How do I use a trial version?

Xceed admin — Mon, 08 Sep 2008 19:58:41 GMT

.NET PRODUCTS

Xceed's .NET components can be used without a license key for a 45-day trial period. During this time, the components are fully functional. However, trial period reminder notices will be displayed for the duration of the trial or until a registered license key is set in your code.

The trial period for Xceed's components begins at the time of installation. Once the trial period has ended, a registered license key is needed to continue using them (see the How to license a component once you purchase page for details). If you attempt to use a component after the trial period without a registered license key, an exception will be thrown and you will not be able to use it.

Using Xceed's .NET components during the trial period

All you need to do is the following:

1- Install the components using the Xceed Installer application. There is no need to set a license key.

2- Try the components for up to 45 days.

3- Purchase a license to continue using them or to deploy your application.

Deploying to another machine for testing purposes

If you wish to temporarily deploy an application to another machine for testing purposes during the trial period, follow these steps:

1- Get a temporary license key from the Xceed Component Licenser application, which is normally found under the Xceed Components folder in the Start Menu.

2- Set the component's Licenser.LicenseKey property with this temporary license key. For detailed instructions, see the LicenseKey property section on the How to license the component once you purchase page.

3- Compile your application and deploy it to the test machine.

Special Considerations for Xceed DataGrid for WPF

There are 3 possible licensing scenarios:

1- Express Edition (starts with DGF)

Your Express Edition license key (starts with DGF) is automatically sent by e-mail when you register to download Xceed DataGrid for WPF. If the component is unlocked using an Express Edition license key, all features available to users of the Express Edition will be permanently unlocked. Features reserved for the Professional Edition (e.g., Fixed columns) will be disabled and throw an exception if they are used. To evaluate the features that are reserved for the Professional Edition, refer to scenario 3.

2- Professional Edition (starts with DGP)

Xceed DataGrid for WPF Professional Edition license keys (starts with DGP) permanently unlock the component's complete feature set.

3- Using the default 45-day trial mode (no license key).

Features available only in the Professional Edition (e.g., Fixed columns) can be evaluated for a 45-day period after which an exception will be thrown. To use this mode, no license key is required.

ACTIVEX PRODUCTS

For the ActiveX products, regardless of if you are using a trial or registered version of Xceed components, the License method must be called before any other of the components methods or properties.

What do I need to distribute along with my applications?

Xceed admin — Mon, 08 Sep 2008 19:57:34 GMT

For any Xceed product, you only need to distribute the DLL(s).

For the ActiveX versions, the DLL must be registered on the client's machine (by your install program, or by running the REGSVR32.EXE program).

In the case of the Xceed Zip Compression Library, if you are using the library through the DLL API, then you do not need to register the file - you will, however, need to place it in the client's Windows System directory.

Users of the Self-Extractor Module will also need to distribute either the XCDSFX32.BIN or XCDSFX16.BIN file if they are creating self-extracting zip files on the client machines. If you are only distributing self-extracting zip files, then you do not need to distribute the BIN files nor the XceedZip.DLL.

For the .NET versions of our products, the assemblies need to be installed into the Global Assembly Cache or placed in the same directory as the EXE.

A complete list of the assmblies and dlls that must be distributed for each component can be found in their respective documentations.

If I purchase an Xceed product, does the source code come with it?

Xceed admin — Fri, 05 Sep 2008 16:38:23 GMT

The source code for the ActiveX/COM versions of Xceed components is not available for purchase however the source code for the .NET components is available when you purchase the BluePrint Edition.