Bulb License tutorial

Thank you for your purchase.

The following tutorial will help you configure your application correctly and put the license file in appropriate place.

License file ("WhoisLicense.xml" you received after purchase via email or download link) is loaded from the run folder of your application (AppDomain.CurrentDomain.BaseDirectory).

Visual Studio 2005, 2008, 2010

In Visual Studio 2005, 2008, 2010 you can configure "WhoisLicense.xml" file in your project, so it's always copied to your output directory:
  1. Right click on your project in Visual Studio in Solution Explorer.
  2. Click "Add" then "Existing item..."
  3. In "Files of type:" combo choose "All Files (*.*)".
  4. Browse to "WhoisLicense.xml" file and click "Add" button.
  5. Right click on "WhoisLicense.xml" file in Solution Explorer and click "Properties".
  6. On Properties pane change "Copy to Output Directory" option to "Copy if newer".
Copy license to output folder

ASP.NET and WebServices

"WhoisLicense.xml" should be in the root folder of your web application (the folder with the "web.config" file).

WindowsServices

"WhoisLicense.xml" should be in the run folder of your windows service. By default it is 'c:\Windows\System32' or 'c:\WINNT\System32' folder.

Please use the LicenseHelper described below to check the exact path.

Security

Remember also that your application needs to have read access to this file. It is especially important when, for example, you are developing WindowsService that runs on specific Windows account.

Library uses following code to assert that it has permissions to read the file:

Additional information

You can use LicenseHelper class to obtain the exact path, and the current status of the license:

License file is read once per application-run, so remember to restart your application after placing the file in appropriate folder.

Machine key store

In rare cases when you use impersonation you'll need to put the following line in your application start up code (e.g. in Global.asax in Application_Start method). It tells .NET runtime to persist keys in the computer's key store instead of the user profile store.

Documentation:

 
Products > Whois.dll .NET whois component > Whois.dll whois component help > License tutorial