Infragistics UltraWinTree Readme

UltraWinTreeTM)

.NET Windows Forms Control

v2.00.5001.19.01 - June, 2003

Windsor Corporate Park, 50 Millstone Road, Building 200 - Suite 150, East Windsor, NJ 08520 USA

Voice (609) 448-2000, Fax (609) 448-2017, http://www.infragistics.com

.NET Framework Compatibility:
All included assemblies have been built against the Microsoft .NET framework 1.0 RTM build. You must have either the 1.0 or 1.1 RTM build of the framework installed for the product to work.

Updating Projects to Work with Version 2 Controls

This topic provides important information about updating exisitng projects to work with the Version 2 Infragistics controls. Version 2 controls are the .NET DLL files for Infragistics products that have been updated to reference the Version 2 Shared and Win common assemblies.

Version 2 Update Overview

The names of the assembly files for the Version 2 controls have been changed. They now have ".v2" appended to their names. So for example, the version 1 UltraWinGrid control assembly was distributed in a file called Infragistics.Win.UltraWinGrid.dll. The Version 2 UltraWinGrid assembly is named Infragistics.Win.UltraWinGrid.v2.dll.

This naming convention allows both version 1 and version 2 controls to coexist in the Visual Studio toolbox. The version 2 controls will display a red triangle in the upper left corner of their toolbox icons to distinguish them from the Version 1 versions. In order to make version upgrading as painless as possible the internal namespaces have not been changed. This means that you do not have to change any of your code when updating projects from Version 1 to Version 2.

However, since all the controls share the common framework assemblies, this also means that none of the Version 1 controls can coexist with Version 2 controls in the same project. For example, you cannot have a Version 2 UltraWinGrid control in the same project as a Version 1 UltraWinListbar control.

Procedure for Updating Projects

To convert an existing project to use version 2 of the controls, perform the following steps:

1. Make a backup copy of the project first.

2. Open the project and in the solution explorer expand the 'References' item. Take note of all the 'Infragistics...' references present. This will include at least the Win and Shared assemblies, and possibly other assemblies as well depending on the product.

3. Remove all the old 'Infragistics...' references. Then add the references back in again, using the corresponding '.v2' assemblies. If the V2 versions do not appear in the list (as indicated by the '.v2' names) then installation of your Version 2 assembly was not completed properly. You should re-run the setup program to correct this problem.

4. Rebuild the project. If you get a 'Could not transform licenses file...' error, double-click on it and modify the assembly names by appending '.v2' as in the example below:
Infragistics.Win.UltraWinGrid.UltraGrid, Infragistics.Win.UltraWinGrid.v2, Version=1.0.5005.15, Culture=neutral, PublicKeyToken=7dd5c3163f2cd0cb

5. If you get 'Resource transformation ...' errors, click on the "Show All Files" button at the top of solution explorer. This should add expansion indicators next to the form files. Expand the offending form(s) and open the associated .resx files.

You will need to delete the offending entries. Unfortunately, the error messages don't indicate which entries are bad. However, for beta 1 toolbars projects we know that entries named 'resource.Settings', 'resource.Settings1' etc. need to be deleted. Also old grid projects may have entries with 'DisplayLayout' in the name. These should be deleted. We have also found some Appearances persisted into old project .resx files; these should be deleted also. However, entries with names like 'Appearancex.Image' are valid and should not be deleted.

6. Rebuild the project to incorporate any changes you have made.

INSTALLING HOT FIXES:
Please follow these instructions to install .NET Hot Fixes.

1. To install the Hot Fix assemblies, extract the assembly DLL and its .XML file into your installation folder. The default location for the assemblies is C:\Program Files\Infragistics\PRODUCT NAME\v2.00.5000.

2. If the Hot Fix .ZIP file includes the Infragistics.Win or Infragistics.Shared assemblies, extract these files to C:\Program Files\Common Files\Infragistics\Win\v2.00.5000 and C:\Program Files\Common Files\Infragistics\Shared\v2.00.5000, respectively.

3. Note: If your project uses more than one Infragistics .NET product, you must install the HotFix for all the products used. For example, if you install the Hot Fix for UltraWinGrid, you cannot use UltraWinGrid and UltraWinTree in the same project unless UltraWinTree is upgraded to the Hot Fix, also. All of the Win Forms products rely on the same framework (Infragistics.Win, Infragistics.Shared) which is updated by the Hot Fix.

4. Win Forms (UltraWinGrid, UltraWinListbar, UltraWinTree, UltraWinSchedule) and the Infragistics.Win and Infragistics.Shared Hot Fix assemblies also need to be copied to the GAC (C:\Windows\Assembly). Drag the assemblies from their installed folders into the GAC. After you copy the latest versions to the GAC, be sure to remove any older versions.

It is recommended that you install the Hot Fixes only if you are experiencing a specific issue addressed by the Hot Fix that cannot be satisfactorily resolved by a workaround.

Hot Fix Note:
Hot Fixes may not be included in full suite releases. You may need to reapply your Hot Fix after you have installed a full suite release.

Issues Addressed:
Use the knowledge base in the Infragistics Support Center
http://www.infragistics.com/support/supportcenter.asp
to review the history of addressed issues.
http://www.infragistics.com/process/p_knowledge.asp?product=91&articlestypebugfix=on

UltraWinTree 2.00.5001.19.01 – June, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Compiled against Infragistics.Shared.v2 and Infragisitics.Win.v2 2.00.5001.19
Full Release containing all previous Hot Fixes

UltraWinTree 2.00.5000.32.01 – January, 2003
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Compiled against Infragistics.Shared.v2 and Infragisitics.Win.v2 2.00.5000.32
Full Release containing all previous Hot Fixes

UltraWinTree 2.00.5000.22.01 – December, 2002
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Compiled against Infragistics.Shared.v2 and Infragisitics.Win.v2 2.00.5000.22
- Full Release

UltraWinTree 2.00.5000.16.00 – October, 2002
-------------------------------------------------------------------------------------------------------------------------------------------------------------
Compiled against Infragistics.Shared.v2 and Infragisitics.Win.v2 2.00.5000.16
Version changed for Infragistics Presentation Layer Framework compatibility
- Initial Release