Page Comparison

Upgrade Prerequisites

1. Ensure that you have a backup of your existing VS.NET project.  You may need to reference existing configuration files during the upgrade process, so make sure you have a copy of the original state of your project to work with.
2. Upgrade WIRE Project in VS.NET to a minimum of .NET Framework 3.5

...

This upgrade assumes that you are upgrading a project with the same structure as our starter project WIRE_GUI.

1. Move all config files to root project directory
   
   1. Copy all config files that are in the "bin" folder to the root of the WIRE_GUI directory.
2. Extract the WIRE_ver4.0.zip archive into the root WIRE_GUI directory of your existing project. (This will overwrite your WIRE_GUI.dll.config file, so make sure you have a backup!)
3. Delete the PrintPage.ascx file from the rood WIRE_GUI directory of your existing project.
4. Open the project in Visual Studio
5. If you have references to to assemblies in the "bin" folder
   1. Remove all
   non-System References and add references to all assemblies in lib folder
6. Add Imports statement to WIRE.Common in the following files
   1. CustomScreens.vb
7. Add Imports statement to WIRE.Common and WIRE.Common.Html to the following files
   1. EGUIToolbar.ascx.vb
8. Remove "Option Strict On" from top of the following files
   1. EGUIToolbar.ascx.vb
9. Add the following files/folders to the VS.NET project
   1. references to assemblies in the "bin" folder
   2. Move any dependent assemblies to the "lib" folder (make sure assemblies are removed from "bin")
   3. Reference the following assemblies in the "lib" folder
      1. AjaxPro.2.dll
      2. AssemblySettings.dll
      3. BAMacros.dll
      4. BrandonCollections.dll
      5. DataDictionary.dll
      6. Ionic.Zip.dll
      7. RequestReduce.dll
      8. WIRE.dll
      9. Wire.XmlProfilePersister.dll
      10. WireControls.dll
      11. WireLicense.dll
      12. Wire.Common.dll
10. Include config files in project
    1. Include the WIRE.dll.config, WIRE_GUI.dll.config and DataDictionary.dll.config files into the VS.NET project (right-click on files in VS.NET and choose "Include In Project").
    2. Select all three files in VS.NET and edit the Properties for these files (press F4) to match the following:
       Image Added
11. Copy connections section from your original WIRE_GUI.dll.config file into the updated WIRE_GUI.dll.config file in the root of the WIRE_GUI directory.
12. Include the following files/folders on the VS.NET project (right-click on file in VS.NET and choose "Include in Project")
    
    1. Download.aspx
    2. UserControls directory
    3. Styles directory
       1. wirejquery-ui.cssjquery-ui
       2. wire.css
    4. Javascript directory
       1. clientMenuScript.js
       2. ClientScripts.js
       3. CloseSideWindow.js
       4. jquery-ui.min.js
       5. jquery.js
       6. jquery.plugins.js
       7. jquery.popupwindow.js
       8. lookupBtn.js
       9. Stylesheets.js
       10. vv_search.js
       11. Wire.js
    5. Images directory
       1. AutoZoomOff_disabled.gif
       2. AutoZoomOn_disabled.gif
       3. Classic.gif
       4. ClassicMode.png
       5. Enhanced.gif
       6. EnhancedMode.png
       7. loading-animated-dots.gif
       8. menu_over.png
       9. Standard.gif
       10. StandardMode.png
       11. vv-close-button.png
    6. Images/Button
       1. navbutton.gif
       2. navbutton2.gif
    7. Images/Tabs directory
       1. Rename.png
    8. Images/Toolbar directory
       1. refresh.gif
       2. refresh_disabled.gif
       3. toolbarbg.gif
       4. toolbarbtn_separator.png
13. Build WIRE Application and run.  If compile errors are encountered, see "Troubleshooting Upgrade" below...

Troubleshooting Upgrade

"Type ??? is not defined" or "??? is not declared"

1. If the Type that is not defined is Callback, DisplayModes, EventType, HostTypes or ScreenFilter

   1. Add the following Import to the top of the file reporting the exception

      Code Block
      Imports WIRE.Common

Property 'DisplayMode' is 'ReadOnly'

This usually is caused by referencing the DisplayMode property on the HostSession object.  This is a breaking change in between WIRE 3 and 4, and should be changed to "HostSession.DisplayModeMax".

Related articles