Support Center

GemBox.Document Free, Trial and Professional

GemBox.Document has three working modes (Free, Trial and Professional) which use the same GemBox.Document assembly. Every working mode delivers the same performances and set of features and can work in unlimited time period, but Free and Trial modes do have some restrictions applied to them.

Before using any other class from GemBox.Document assembly it is necessary to call a SetLicense method to set the license (serial) key. This method can be called multiple times, but the key can only be set once (if you try another key, exception will be thrown). The best place to call this method is from static constructor of from your application's main class.

Free mode

The default behaviour of GemBox.Document in Free mode is that a FreeLimitReachedException will be thrown when loading or saving a document, if a document content has more than 20 paragraphs.
This behaviour can be overridden, to achieve trimming of a document content to first 20 paragraphs when loading or saving a document, by handling a ComponentInfo.FreeLimitReached event and setting the FreeLimitEventArgs.FreeLimitReachedAction to FreeLimitReachedAction.Stop.

C# code

// Set license key to use GemBox.Document in a Free mode.
ComponentInfo.SetLicense("FREE-LIMITED-KEY");

// Stop reading/writing a document when the free limit is reached.
ComponentInfo.FreeLimitReached += (sender, e) => e.FreeLimitReachedAction = FreeLimitReachedAction.Stop;

VB.NET code

' Set license key to use GemBox.Document in a Free mode.
ComponentInfo.SetLicense("FREE-LIMITED-KEY")

' Stop reading/writing a document when the free limit is reached.
AddHandler ComponentInfo.FreeLimitReached, Sub(sender, e) e.FreeLimitReachedAction = FreeLimitReachedAction.Stop

Trial mode

For evaluating beyond the first 20 paragraphs GemBox.Document offers a Trial mode.
Free and Trial versions use the same key: FREE-LIMITED-KEY.
To use GemBox.Document in Trial mode requires to subscribe to the ComponentInfo.FreeLimitReached event and set FreeLimitEventArgs.FreeLimitReachedAction to FreeLimitReachedAction.ContinueAsTrial.

C# code

// Set license key to use GemBox.Document in a Free mode.
ComponentInfo.SetLicense("FREE-LIMITED-KEY");

// Continue to use the component in a Trial mode when free limit is reached.
ComponentInfo.FreeLimitReached += (sender, e) => e.FreeLimitReachedAction = FreeLimitReachedAction.ContinueAsTrial;

VB.NET code

' Set license key to use GemBox.Document in a Free mode.
ComponentInfo.SetLicense("FREE-LIMITED-KEY")

' Continue to use the component in a Trial mode when free limit is reached.
AddHandler ComponentInfo.FreeLimitReached, Sub(sender, e) e.FreeLimitReachedAction = FreeLimitReachedAction.ContinueAsTrial

For more information see the GemBox.Document performance sample.

Limitations of Trial version are:
- When loading a document - random parts of document text will be replaced with string TRIAL.
- When saving a document - promotional header will be added to every document page and will replace any existing header.

Professional mode

Using the component in a professional mode, which has no limitations, requires using a license key. License keys can be purchased from the GemBox.Document web shop page.

C# code

// Set license key to use GemBox.Document in a Professional mode.
ComponentInfo.SetLicense("your-professional-license-key");

VB.NET code

' Set license key to use GemBox.Document in a Professional mode.
ComponentInfo.SetLicense("your-professional-license-key")

For more information visit the GemBox.Document Evaluation and Licensing help page.

13 of 15 people found this page helpful
Subscribe to this article to get an email notification when it is updated.

0 Comments

  • There are no comments.