ComponentOne Installation

1) Installation Details

The product (binary files, help) is installed here:

Program Files\ComponentOne\<PRODUCT NAME>

Samples are installed here:

Documents And Settings\<USER NAME>\ComponentOne Samples\<PRODUCT NAME>

Samples are not installed under the Program Files folder because access to that folder requires elevated permissions, which would make using the samples impractical.

2) Adding Controls to the Toolbox.

The installation tries to add ComponentOne controls to your Visual Studio toolbox automatically.

If you do not see any ComponentOne controls in your toolbox you will have to add them manually.

To add controls manually:

Right-click the Toolbox window and select the "Choose Items..." option.
Select the correct tab (.NET, WPF or Silverlight).
Then select the components from the list and click OK.

If you do not see any ComponentOne controls in the list, you can find them by clicking "Browse..." and selecting the binary files (.dll) located at the installation directory listed above (#1 Installation Details).

To remove controls from the toolbox, select them in the Toolbox window and press the "Delete" key.

Note: If you added the Toolbox controls manually, it's important to Exit Visual Studio formally via the File - Exit menu option if you want your Toolbox settings to save.

3) Licensing and Version Numbers

Your ComponentOne subscription includes one year of free updates. This means your license key will work with new versions released up to a year after the date of the original purchase. After one year, your license key will no longer work with new releases, and you will have to renew the subscription to get a new key and one more year of updates.

ComponentOne products have version numbers with the following format:

<major>.<minor>.YYYYV.<build>

The YYYYV part of the version number represents the year and version.
ComponentOne releases official updates to its products three times per year, so the V digit is always 1, 2, or 3. For example, 1.0.20091.123 means 2009/v1.

In addition to the official updates, ComponentOne may release interim maintenance builds. These builds have the same YYYYV version number as the last official build, but a higher <build> number. Interim builds can always be obtained at http://prerelease.componentone.com.

You can check for new maintenance releases automatically using the C1Live utility which installs at Program Files\ComponentOne\C1Live.

For more details about licensing, please visit our site and check the End Users License Agreement at http://www.componentone.com/SuperPages/DevToolsEULA/ .

4) Updating the Controls

If you updated your controls by downloading a new setup and installing it, or by running C1Live, the controls will automatically be copied to the right location.

If you downloaded new versions from http://prerelease.componentone.com, then you should copy them to the right location manually, overwriting the old versions:

Program Files\ComponentOne\<PRODUCT NAME>

Once the new version has been installed, you will need to open your projects in Visual Studio, update the dll references, and rebuild the project.

Note: Updates will be easier if you select the assembly reference in your project and then set the "Specific Version" property to "False" in the property window. This will cause Visual Studio to use any version of the assembly it can find (the one you just installed), instead of looking for a specific one (the one used when the project was created and overwritten during the update). This will help prevent unlicensed nag screens from showing at run-time.

5) Updating Your License File

After you've updated your controls you will need to update your project's license file to avoid unlicensed nag screens at run-time.

The easiest way to do this is to locate your licenses.licx file and remove all version specific information from each line referencing a ComponentOne control.

For example:

C1.Win.C1FlexGrid.C1FlexGrid, C1.Win.C1FlexGrid.2, Version=2.6.20093.427, Culture=neutral, PublicKeyToken=79882d576c6336da

Should be modified to just include:

C1.Win.C1FlexGrid.C1FlexGrid, C1.Win.C1FlexGrid.2

Your licenses.licx file is located within your Projects directory structure. It is sometimes necessary to click "Show All Files" in the Solution Explorer window to see .licx files.

Rebuild your project to reflect new licensing changes. With ASP.NET web sites, you should also right-click your App_Licenses.dll, which is located in the bin directory, and select "Update Licenses."

6) Help and Support

If you need help with the product, or have any requests/suggestions, several options are available:

Forums (http://our.componentone.com/groups/) Post your questions here and they will usually be answered in a day or two, by our technical support, developers, or by other users.
Phone (412.681.4738 ) Phone support is available to customers that purchase the Platinum Support option with their subscription. This is the usually the fastest way to get support since you will be able to describe the issue exactly, directly to our technical support staff. Because it is a paid option, questions submitted by phone have the highest priority.

We also offer free installation phone support to customers, so don't hesitate to call if you have any questions during the install.