|Evaluation and Licensing|
GemBox.Document works in two different modes:
Free mode - free of charge, limited to 20 paragraphs.
Trial mode - free of charge, random parts of document text will be replaced with string TRIAL, promotional header will be added to every document page.
Professional mode - requires purchasing a license key, no limitations.
All modes use the same GemBox.Document DLL so there is no need to reinstall the component when switching modes.
The first thing to do when coding with GemBox.Document is to instruct the component in which mode it will be used. This is accomplished by calling ComponentInfoSetLicense(String) method with the specific license key parameter:
FREE-LIMITED-KEY, to use the component in Free mode.
The license key that you receive after purchasing GemBox.Document, to use the component in Professional mode.
ComponentInfo.SetLicense method must be called before using any other class from GemBox.Document component.
ComponentInfo.SetLicense method can be called multiple times. What is important is that it is called with the same license key.
Ideally, it should be called at the startup of your application. For example, it can be called in a Main method, an application startup event or a static constructor of your main class.
Free mode delivers the same performance and set of features as Professional mode, with the following limitations:
FreeLimitReachedException will be thrown when loading or saving a document, if document content has more than 20 paragraphs.
Document content will be trimmed to first 20 paragraphs when loading or saving a document, if you handle ComponentInfoFreeLimitReached event and set the FreeLimitEventArgsFreeLimitReachedAction to FreeLimitReachedActionStop.
If you want to evaluate GemBox.Document performance beyond the first 20 paragraphs, then handle ComponentInfoFreeLimitReached event and set the FreeLimitEventArgsFreeLimitReachedAction to FreeLimitReachedActionContinueAsTrial, as in this following code snippet:
// 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; // Here goes your application specific 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 ' Note: Single-line Sub Lambdas are supported from Visual Basic 10 compiler. See: http://msdn.microsoft.com/en-us/library/ff637436.aspx#code-snippet-5 ' If you are using Visual Basic 9 or older Visual Basic compiler, then you must extract event handler to a method and assign it as an event handler. ' Here goes your application specific code.
This option will enable you to read / write entire document content, with the following limitations imposed after the first 20 paragraphs:
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.
If you have evaluated the component and are satisfied with it, you can purchase the license key to use the component in the Professional mode - without any limitations.
After purchase, the only thing you need to do is to replace FREE-LIMITED-KEY with your purchased license key in ComponentInfoSetLicense(String) method call.
There is no other installer or DLL for the Professional mode. You should continue to use the reference to existing GemBox.Document DLL in your project when switching to Professional mode.
Professional mode also includes technical support with prompt bug fixes. For more information, see Technical Support.