Jigsaw Blog



Converting a site from Gaia 3.5 to 3.6 in 5 Minutes

  1. Open the website in Visual Studio
    Note the names of the current Gaia dll's being used.
    In my case these are
    - Gaia.WebWidgets
    - Gaia.WebWidgets.Extensions


  2. Delete from the bin folder the current Gaia dll's

    We need to add references to the new dll's


  3. Right-click on the Bin Folder and select "Add Reference"
  4. Select the browse tab and navigate to the Gaia 3.6 files.
    By default these are found in C:\Program Files\Gaia Ajax 3.6\Library
  5. Select the dll's you require and click OK.
    In my case I need
    - Gaia.WebWidgets
    - Gaia.WebWidgets.Extensions


  6. The new dll's are added to the project.
    Any additional dll's required to support the selected ones are also added

    In my case you'll see Gaia.WebWidgets.Effects has also been added


  7. Build the site, oops


  8. Update the project code to remove ambiguous references.
    In my case the ambiguous references where due to Validation and GridViewRow objects that now also exist in Gaia 3.6.
    To fix this I simply added to my c# code
    using CustomValidator = System.Web.UI.WebControls.CustomValidator;
    using GridViewRow = System.Web.UI.WebControls.GridViewRow;
    using RequiredFieldValidator = System.Web.UI.WebControls.RequiredFieldValidator;


  9. Build the site, now only have Warnings related to Effects


  10. The way effects are used has changed from 3.5 to 3.6. To change to the new syntax we need to add a reference to Effects in our source code. (Effects are now in a different namespace)

     using Gaia.WebWidgets.Effects;

    Now convert to the new syntax


    new Gaia.WebWidgets.Effect(pnlStatus,Gaia.WebWidgets. Effect.TypeOfEffect.Appear);

    new Gaia.WebWidgets.Effect(pnlStatus,Gaia.WebWidgets. Effect.TypeOfEffect.Fade, 5000);

    Change to

    pnlStatus.Effects.Add(new EffectAppear());
    pnlStatus.Effects.Add(new EffectFade(5000));


  11. Build the site..no Errors or Warnings


    Done. Took 5 miuntes

    To complete the update I could change to the new Gaia 3.6 controls for GridViews and Validators.