RequiresAuthentication Property (UXPage)

Gets or sets a value indicating whether the page requires the User to be authenticated in order to access the page.

Syntax

Visual Basic (Declaration)
Visual Basic (Usage)
C#
C++/CLI

<CategoryAttribute("Authentication")>
Public Property RequiresAuthentication As Boolean

Dim instance As UXPage
Dim value As Boolean
 
instance.RequiresAuthentication = value
 
value = instance.RequiresAuthentication

[CategoryAttribute("Authentication")]
public bool RequiresAuthentication {get; set;}

[CategoryAttribute("Authentication")]
public:
property bool RequiresAuthentication {
   bool get();
   void set (    bool value);
}

Remarks

In many line-of-business scenarios, your application may require certain pages to authenticate against the current user. ClientUI navigation framework includes built-in authentication feature which is implemented at the core navigation process in the UXFrame and UXPage class. This ensures high security protection as the authentication process is built into the framework, which eliminate the need of additional workaround or plumbing code.

To implement authentication, you set the User property of the frame to an object that implements IPrincipal interface. Since the User property relies on IPrincipal interface which is implemented in the Silverlight runtime, the authentication feature in ClientUI navigation framework allows you to flexibly use any kind of authentication providers such as WCF Authentication Service, or other third party's authentication services. For scalable authentication implementation that produces consistent result, it is recommended that you use MVVM pattern to maintain the user authentication, which is generally achieved by binding the User property to an authentication context defined in ViewModel.

Once you have defined the User property, you can easily set the pages of which the authentication is required by setting the RequiresAuthentication property of those pages to true. Role-based security is also supported through the same authentication context that implemented in the User property.

For more information, see Advanced Features in ClientUI Navigation Framework.

Example

The following example shows how to setup a UXPage to require user authentication.

XAML

<Intersoft:UXPage 
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:Intersoft="http://intersoft.clientui.com/schemas"
        RequiresAuthentication="True"
    ...>

</Intersoft:UXPage>

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

UXPage Class
UXPage Members
Navigation Overview