How to license the component once you purchase

Glossary Item Box

Introduction

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

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

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

  3. 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@xceed.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.

Zip/compression capabilities

To use the Zip capabilities with SFX (self-extracting Zip file) support, set the LicenseKey property as follows (using your own valid license key); note that the key begins with "SFN":

VB.NET Copy Code
Xceed.Zip.Licenser.LicenseKey = "SFNXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.Zip.Licenser.LicenseKey = "SFNXX-XXXXX-XXXXX-XXXX";

To use the Zip capabilities without SFX support, set the LicenseKey property as follows (using your own valid license key); note that the key begins with "ZIN":

VB.NET Copy Code
Xceed.Zip.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.Zip.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX";

Setting the LicenseKey property of the Licenser class in the Xceed.Zip namespace will also register the classes in the Xceed.FileSystem and Xceed.Compression namespaces. 

If you are only using the classes contained within the Xceed.FileSystem namespace, you can set the LicenseKey property of the Licenser class contained within this namespace:

VB.NET Copy Code
Xceed.FileSystem.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.FileSystem.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX";
The same applies if you are only using the classes contained within the Xceed.Compression namespace:
VB.NET Copy Code
Xceed.Compression.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.Compression.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX";

To use the Tar and GZip capabilities, simply set the LicenseKey of the Licenser class using the Zip key. Note that by setting the LicenseKey property on Tar, you also unlock the GZip capabilities:
VB.NET Copy Code
Xceed.Tar.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.Tar.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX";

If you only wish to use the GZip capabilities, set the LicenseKey property as follows:
VB.NET Copy Code
Xceed.GZip.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.GZip.Licenser.LicenseKey = "ZINXX-XXXXX-XXXXX-XXXX";

FTP capabilities

To use the FTP capabilities, set the LicenseKey property as follows:
VB.NET Copy Code
Xceed.Ftp.Licenser.LicenseKey = "FTNXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.Ftp.Licenser.LicenseKey = "FTNXX-XXXXX-XXXXX-XXXX";

Compact Framework components

To use Xceed's Zip or FTP .NET CF components, setting the license key is the same as described above, but the appropriate Compact Framework license key is used instead:
VB.NET Copy Code
Xceed.Zip.Licenser.LicenseKey = "ZICXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.Zip.Licenser.LicenseKey = "ZICXX-XXXXX-XXXXX-XXXX";

or
VB.NET Copy Code
Xceed.Ftp.Licenser.LicenseKey = "FTCXX-XXXXX-XXXXX-XXXX"
C# Copy Code
Xceed.Ftp.Licenser.LicenseKey = "FTCXX-XXXXX-XXXXX-XXXX";
 

Note: This product is only compatible with .NET Framework 2.0. A version compatible with .NET Framework 1.1 is available for download on Xceed’s website (http://xceed.com), but future updates to the .NET 1.1 version will be limited to bugfixes. You cannot install different versions of the full package at the same time. However, if you need work with both .NET 2.0 and .NET 1.1 components, first install the .NET 2.0 package, then install the latest service pack for the .NET 1.1 versions and follow the included instructions.