WEBfactory 2010

Upgrading a Silverlight project to Silverlight 5 using Visual Studio

As WEBfactory 2010 version 3.6 comes with Silverlight 5, any existing projects based on the Silverlight framework must be upgraded to the latest version of the framework, Silverlight 5. This article will guide you through the steps required to upgrade your projects using Visual Studio.

Existing SmartEditor projects are update automatically to Silverlight 5.

After upgrading your WEBfactory 2010 installation to version 3.6, all the dll files from the Silverlight/Standard folder will be updated to version 3.6.x. This article covers three possible scenarios:

If, for any project, the referenced DLL files have a different location than the default one (the Silverlight/Standard folder from the installation directory), you need to replace the old DLL files with the latest version provided by the WEBfactory 2010 3.6 Setup.

All the projects inside a solution must be updated to Silverlight 5.

IMPORTANT: Silverlight 5 Toolkit must be installed!

Upgrading a project to Silverlight 5
  1. Backup your project and the database.

  2. Navigate to the project folder on the disk and delete the Bin and Obj folders. This will make sure that no errors will occur when updating the references.

  3. Open the project in Visual Studio 2012.

  4. Right-click on the Silverlight project and select Properties (or press Alt + Enter while the project is selected).

    Capture2825.jpg
  5. In the Properties window, on the Silverlight tab, go to Silverlight build options and set the Target Silverlight Version to Silverlight 5.

    Capture2826.jpg
  6. Confirm the Target Framework Change dialog and close the Properties window.

    Capture2827.jpg
  7. Back in the Solution Explorer, besides the Silverlight project, you will have either a Site project (e.g. SilverlightApplication1Site) or a Web project (e.g. SilverlightApplication1.Web). In both situations, the Target Framework version needs to be set to .NET Framework 4.5:

For Site projects (e.g. SilverlightApplication1Site):
  1. Right click on the Site project and select Property Pages.

    Capture2828.jpg
  2. In the Property Pages window, select the Build section from the left side panel. Set the Target Framework to .NET Framework 4.5.

    Capture2829.jpg
  3. Click OK to confirm the change and also confirm the Target Framework Change dialog.

    Capture2830.jpg
For Web projects (e.g. SilverlightApplication1.Web)
  1. Right-click on the Web project and select Properties.

    Capture2831.jpg
  2. In the Properties window, under the Application tab, set the Target framework to .NET Framework 4.5.

    Capture2832.jpg
  3. Confirm the Target Framework Change dialog and close the Properties page.

    Capture2833.jpg
  4. In the Solution Explorer, expand the References folder under the Silverlight project. The referenced WEBfactory DLL files must be manually updated to the Silverlight 5 version.

  5. Select the references and from the contextual menu, select Remove (or press the Delete key). Confirm the reference removal.

    Capture2834.jpg
  6. Right-click on the References folder and select Add Reference....

    Capture2835.jpg
  7. In the Reference Manager, use the Browse button to locate the new version of the DLL files. You can either use the Standard folder from the default WEBfactory 2010 installation directory or another folder containing the DLL files provided by the WEBfactory 2010 version 3.6 setup.

    Capture2836.jpg
  8. After selecting the new DLL files, click OK to confirm the references.

    Capture4180.jpg

    Note that the names of the Silverlight 5 version of the ComponentOne DLL files have .5 appended.

  9. Clean the project and rebuild it. The project is now updated to Silverlight 5.

Upgrading a project using a re-skinned WFTrending3 control to Silverlight 5

This section describes the additional steps required to upgrade a project with a re-skinned WFTrending3 control to Silverlight 5. All the steps from the previous section, Upgrading a project to Silverlight 5, must be applied before.

When upgrading a project containing a re-skinned WFTrending3 control, the ComponentOne namespace of the new style (xmlns:c1) must be update to http://schemas.componentone.com/winfx/2006/xaml.

  1. Locate the style of the skinned WFTrending3 control.

  2. Find the obsolete ComponentOne namespace: clr-namespace:C1.Silverlight.Chart;assembly=C1.Silverlight.Chart.

    Capture2838.jpg
  3. Replace it with the new one: http://schemas.componentone.com/winfx/2006/xaml.

    Capture2839.jpg

    Alternatively, you can use the Find and Replace functionality of Visual Studio 2012 to quickly find the old namespace and replace it with the new one.

  4. Clean the project and rebuild it. The project is now updated to Silverlight 5.

Upgrading a project with Service References to WEBfactory services to Silverlight 5

This section describes the additional steps required to upgrade a project having Service References to WEBfactory services to Silverlight 5. All the steps from the previous section, Upgrading a project to Silverlight 5, must be applied before.

  1. In the Solution Explorer, expand the Service References folder inside the Silverlight project.

  2. Select all the service references and right-click. Select Update Service Reference.

    Capture2840.jpg
  3. Wait until the update is finished. Clean the project and rebuild it. The project is now updated to Silverlight 5.

Upgrading a project with WEBfactory User Manager to Silverlight 5

This section describes the additional steps required to upgrade a project containing the WEBfactory User Manager to WEBfactory services to Silverlight 5. All the steps from the previous section, Upgrading a project to Silverlight 5, must be applied before.

The User Manager specific references must be manually replaced with the newer versions (remove and add them again using the new DLL files):

  • System.ServiceModel.DomainServices.EntityFramework.dll

  • System.ServiceModel.DomainServices.Hosting.dll

  • System.ServiceModel.DomainServices.Server.dll

  • WFUserManagementRIAServices.Web.dll

The required DLL files are located in the Studio/UserManager/bin folder, inside the WEBfactory 2010 installation directory.

If using a Site project, the references to these DLL files are located in the Bin folder.

Capture2843.jpg

If using a Web project, the references to these DLL files are located in the References folder.

Capture2844.jpg