1. Click Start

2. Select Programs

3. Select Microsoft Visual Studio .NET 2003

4. Click Microsoft Visual Studio .NET 2003 to start .NET 2003 development environment

Microsoft Upgrade Tools will handle about 80% of the conversion (depending on the project). But unfortunately the rest of the work has to be done manually.

1. Within .NET 2003 development environment click Open Project button

2. Select a VB6 project (vbp file)

3. Welcome to Visual Basic Upgrade Wizard window will open, Click Next

4. Choose a project Type: ensure that “DLL/custom control library” is selected, Click Next

5. Select the new VB.NET project directory name and location

6. Folder does not exist, create it? Click Yes, then click Next to begin

7. If you receive an Upgrade Failed error, it is because referenced modules from the VB6 project cannot be found in the specified location.  Copy the modules folder to the correct location and repeat from step 2

Any controls in the original VB6 project that are not Microsoft standard controls will not be converted to the corresponding new .NET assemblies (The upgrade tools have no way of knowing there is any new .NET assembly for a given COM component). Instead the upgrade tools will treat the control just as there is no corresponding .NET assembly. It will create the interop/Ax* wrappers for the control (COM). Since all the TPRI standard controls are converted to .NET there is no need to keep any of the interop/Ax files around anymore.

Most of the common modules are included in the TPRI.BaseControl or TPRI.BaseScreen. But there are situations that some of the screens have their own special module(s). In that case the module(s) should remain in the project.

The .NET version of IobjSafe is implemented in the section: Signing of TPRI Screens.

The option of using Namespace to group the assemblies will also change the way we name the solutions, projects and classes.

1. In windows explorer, browse to newly created project directory

2. Delete the directory _UpgradeReport_Files

3. Delete the files:
   _UpgradeReport.htm
   ErrRpt.vb
   IobjSafe.vb
   Modules.vb
   Any Interop/Ax*.dll file
   Any Interop/Ax*.vb file

4. Back in the solution explorer of the .NET design environment:

5. Change the file names accordingly:
   solution name
   project name
   .vb name

6. Delete the files:

   _UpgradeReport.htm
   ErrRpt.vb
   IobjSafe.vb
   Modules.vb
   Any Interop/Ax*.dll file
   Any Interop/Ax*.vb file

7. Save all files

For the same reason stated above there is no need to keep any of the interop/Ax or IObjectSafety reference anymore. It is also important to remove any COM object reference. Replace the COM components with the corresponding .NET assemblies.

1. Expand the References folder

2. Replace any reference to Interop/Axtpri* with corresponding tpri .NET control

• Easiest way is to add all references first:
  Right-click References, select Add Reference
  Browse to the Bin directory which contains the tpri control dlls and select the corresponding TPRI.* file
  Continue to browse to add the rest of the tpri controls
  Be sure to add the TPRI.BaseScreen and TPRI.BaseControl references

3. If you receive an error concerning changing where the array references are found, click OK

4. Remove the references:

• IObjectSafetyTLB
  VBRUN
  Std*
  MSDATASRC
  Any AxucxxxxxArray

5. Add any other necessary .NET reference

• TPRI.xxxx
  TPRI.shape is needed when TPRI.ActiveShape is used
  Gigasoft.ProEssentials.dll
  C1.win.c1flexgrid.dll
  C1.Common.dll
  …

'Statement Option Explicit On' forces explicit declaration of all the variables in the module. (The default: Option Explicit On)

VB6 is not a type-safe language. VB.Net is type-safe (like C). 'Statement Option Strict On' enforces strict type checking. (The default: Option Strict Off)

1. View Code of ProjectName.vb

2. At the top, set the Options:
   Option Explicit On
   Option Strict On

3. On the following line, Remove the control class attribute: <System.Runtime.InteropServices.ProgId("ucxxxx_NET.ucxxxx")>

4. Change the Public Class name to match the project name