This example shows how to navigate to a UXPage that located in an external ApplicationPackage based on the target URI of the package.

Example

Description

The ClientUI Navigation Framework features an advanced integration to the application framework which allows you to navigate to an external page using the same semantics and mechanism as you navigate to a local page.

You can create user-friendly URI that maps to an external application package by simply defining the URI of the target application package in the MappedUri property. This enables you to design a composite application that allows users to navigate to both local and external page in consistent and intuitive manner.

In standalone mode, you navigate to an external package by defining its target URI directly in the UriMapping definition. Using this approach, the application package is managed individually by the UXFrame. This means that the application package navigated using this approach will not take advantage of the application lifetime features managed by the ClientUI application framework.

To learn how to navigate to an external package that integrated to application framework, see How-to: Navigate to a Page in External ApplicationPackage with Shell Integration .

The following example shows how to configure the UXFrame to support navigation to an external package using standalone (direct URI) approach.

Code

<Intersoft:UXFrame>
    <Intersoft:UXFrame.UriMapper>
        <Intersoft:UriMapper>
            <Intersoft:UriMapping Uri="/Home" MappedUri="/Views/Home.xaml"/>
            <Intersoft:UriMapping Uri="/{page}" MappedUri="/Views/{page}.xaml"/>
            <Intersoft:UriMapping Uri="/App1" MappedUri="ExternalClientUIApp1.xap"/>
        </Intersoft:UriMapper>
    </Intersoft:UXFrame.UriMapper>
</Intersoft:UXFrame>

The above example presumes that a ExternalClientUIApp1.xap file existed in the ClientBin of the Web project, which should be the same folder where the root application existed.

You can initiate page navigation from controls that implement INavigationSource such as UXButton, UXNavigationButton, UXMenuItem and more. For more information, see Navigation Sources Overview.

The following sample shows how to perform page navigation using UXButton.

<Intersoft:UXButton Content="Navigate to App1" NavigateUri="/App1" />

To create a new ClientUI Application, you use the ClientUI project templates installed in Visual Studio 2010. For more information, see Introduction to ClientUI Project Templates.