This documentation is archived and is not being maintained.

Upgrade Wizard: Add Project References

Visual Studio 2005

The Visual J# Upgrade Wizard attempts to analyze your Visual J++ 6.0 project files to determine the properties for the upgraded Visual J# project, as well as identify any unsupported APIs or compatibility issues. To analyze the sources completely, the wizard requires references to all classes used in the Visual J++ 6.0 project that are not defined in the project itself or in Visual J# class libraries. See Class Library Support for a list of supported classes under Visual J#. References to COM type libraries describing COM classes or interfaces used in the project are also needed for the analysis to be complete.

If your project does have external references, and you choose not to add these references using this wizard page, the wizard can upgrade the Visual J++ 6.0 project to Visual J#. However, to build and run the upgraded project, you may need to add the external references to the project later.

The CLASSPATH setting defined for the Visual J++ project, if any, is displayed on this wizard page. You can then identify the locations of external references.

Click the Add button to select one or more .NET Framework components, also referred to as .NET Framework class libraries or assemblies, or COM type libraries to add to the references list. Use the Remove button to remove items from the list.

The .NET Framework and COM components added to the references list will be added to the upgraded project's references list.

It is recommended that you add all known references to the list before upgrading. If you do not add items to the references list, the upgrade analysis will attempt to identify unresolved external references in the project, as follows:

  • The registry will be searched for COM references.

  • Class references will be searched in the CLASSPATH defined in the Visual J++ project.

If your Visual J++ project uses classes from another library or project, you should add a reference to them. Under Visual J++ 6.0, the CLASSPATH setting of the project is used to search for referenced classes. If any of these classes are not part of the Visual J# class libraries, you will need to add a reference to a class library (DLL) that contains implementations of the referenced classes.

If your Visual J++ project uses classes or interfaces defined in a COM DLL or type library, you can add the DLL or type library (.tlb) file to the references list. If classes in your project extend or implement classes and interfaces defined externally and references to them are not available, analysis may be incomplete for those classes.

If you do not have the source files, you can convert class (.class) files or archive (.cab, .jar, or .zip) files to class libraries using the Visual J# Binary Converter Tool.