This topic describes how to use Visual Studio 2010 to create and build a new ClientUI Advanced Navigation Application project.

Prerequisites

You need the following components to complete this walkthrough:

• Visual Studio 2010
• Silverlight 4 Tools for Visual Studio 2010
• Intersoft ClientUI

Intersoft Advanced Navigation Application Project

A advanced navigation application project is created by using the Intersoft ClientUI Advanced Navigation Application project template. Use the following steps to create a new advanced navigation application project. The steps below are based on Visual C# project, similar steps is expected in using Visual Basic.

To create an Intersoft ClientUI advanced navigation application project

1. Start Visual Studio 2010.
2. On the File menu, click New and then Project.
3. The New Project dialog box appears.
4. In the Installed Templates pane, expand the Visual C# node and select Silverlight.
5. In the list of templates, select Intersoft ClientUI Advanced Navigation Application. The following illustration shows an example of the Silverlight project templates.
   
6. Specify a Name and a Location for the application and then click OK.
   The New Silverlight Application dialog box appears as shown in the following illustration.
   
7. Select a method for hosting your Silverlight application.
   
   1. Uncheck the Host the Silverlight application in a new Web site check box if you do not want to use a Web site to host your Silverlight application. Instead, an HTML test page will be generated to host your application.
   2. Check the Host the Silverlight application in a new Web site check box if you want to add a separate ASP.NET Web site or ASP.NET Web Application Project to your solution to host the Silverlight application. If you select this option, you must also specify the New Web project name and New Web Project Type.
8. From the Silverlight Version drop-down list, select the version of Silverlight that you want to target.
9. Select the Enable WCF RIA Services check box if you want to create a RIA Services link between the client project and the server project.
10. Click the OK button.
11. To build the Silverlight application project, in the Build menu, click Build Solution.
12. To debug the Silverlight application project, in the Debug menu, click Start Debugging.
13. To run the Silverlight application project, in the Debug menu, click Start Without Debugging.

Intersoft ClientUI Advanced Navigation Application Project Files

An Intersoft ClientUI Advanced Navigation Application project contains the following configuration, assembly references, and code files:

• AppManifest.xml
  This is the application manifest file that is required to generate the application package. You must not edit this file.
• AssemblyInfo.cs
  This file contains the name and version metadata that is embedded into the generated assembly.
• .xap file
  This is the Silverlight application package. It is generated when the Silverlight application project is built. An application package is a compressed zip file that has a .xap file extension and contains all the files that you need to start your application. 
• The project contains references to the following assemblies:
  • Intersoft.Client.Framework.dll
  • Intersoft.Client.UI.Aqua.dll 
  • Intersoft.Client.UI.Controls.dll
  • Intersoft.Client.UI.Controls.Interactivity.dll
  • Intersoft.Client.UI.Navigation.dll
  • mscorlib.dll
  • System.dll
  • System.ComponentModel.DataAnnotations.dll
  • System.Core.dll
  • System.Net.dll
  • System.Windows.dll
  • System.Windows.Browser.dll
  • System.Windows.Controls.Navigation
  • System.Windows.Interactivity
  • System.Xml.dll
• MainPage files
  The MainPage class is used  as the root visual in the Intersoft ClientUI advanced navigation application. The MainPage contains a UXFrame and UXNavigationButton is used for navigation to the page in Views folder.
  
• Views folder
  This folder contains the pages launched from UXNavigationButton in MainPage.
  • About file
    The About class derives from UXPage.
    
  • Customers file
    The Customers class derives from UXPage.
    
  • Home file
    The Home class derives from UXPage.
    
  • Products file
    The Products class derives from UXPage.
    
  • Reports file
    The Reports class derives from UXPage and implement navigating feature.
    
  • Settings file
    The Settings class derives from UXPage.
     
• ErrorPage file
  The ErrorPage class is used to show an error. This class derives from UXPage.
• App files
  The App class is required by a Silverlight application to display the application user interface. The App class is implemented by using App.xaml and App.xaml.cs. The App class is instantiated by the Silverlight plug-in after the application package (.xap file) is created.
• Assets folder
  This folder contains the images and styles used in the pages in MainPage and Views folder.

Intersoft ClientUI Advanced Navigation Application Project Web Site Files

The Web site contains the following files:

• Silverlight.js
  A JavaScript helper file that contains functions to initialize Silverlight plug-in instances and functions for determining the client's installed version of the plug-in.
• HTML file
  An HTML file that is used to configure and instantiate the Silverlight plug-in, which downloads and runs the Silverlight application. The name of this file is a concatenation of the name of the Silverlight application project and the text "TestPage.html".
• .aspx file
  A .aspx file that is the default startup Web page. The name of this file is a concatenation of the name of the Silverlight application project and the text "TestPage.aspx".
• Web.config
  A Web site configuration file.