Intersoft ClientUI Documentation
IsAuthenticating Property
See Also  Example Send Feedback
Intersoft.Client.UI.Navigation Namespace > UXFrame Class : IsAuthenticating Property






Gets or sets a value indicating whether the UXFrame is currently performing authentication process. When the property is set to true, the UXFrame will delay the navigation process until the authentication process is done.

Syntax

Visual Basic (Declaration) 
Public Property IsAuthenticating As Boolean
Visual Basic (Usage)Copy Code
Dim instance As UXFrame
Dim value As Boolean
 
instance.IsAuthenticating = value
 
value = instance.IsAuthenticating
C# 
public bool IsAuthenticating {get; set;}
Delphi 
public read-write property IsAuthenticating: Boolean; 
JScript 
public function get,set IsAuthenticating : boolean
Managed Extensions for C++ 
public: __property bool get_IsAuthenticating();
public: __property void set_IsAuthenticating( 
   bool value
);
C++/CLI 
public:
property bool IsAuthenticating {
   bool get();
   void set (    bool value);
}

Example

The following example shows how to implement IsAuthenticating property using MVVM pattern to track and control the authentication progress.
XAMLCopy Code
<Intersoft:UXFrame x:Name="ContentFrame"
                   User="{Binding User, Source={StaticResource Shell}}"
                   IsAuthenticating="{Binding IsAuthenticating, Source={StaticResource Shell}}"
                   RedirectUri="/Login">
     <Intersoft:UXFrame.UriMapper>
         ...
     </Intersoft:UXFrame.UriMapper>
</Intersoft:UXFrame>

Remarks

With the nature of Silverlight and WPF as a client-side platform, the user authentication is typically performed through an asynchronous callback to the server-side through web services such WCF RIA Services. In most cases, you want to prevent users to interact with your application while authentication is in progress, such as when login or logout operation is being performed.

UXFrame streamlines the authentication process by providing IsAuthenticating property, which makes it easy for you to track when authentication process is being executed. You can use MVVM pattern to manage this property in your ViewModel.

When the IsAuthenticating property is set to true, UXFrame automatically blocks the page from user interactions thus preventing users to work with the page while the authentication operation is in progress. More importantly, the UXFrame will hold the current navigation request until the authentication process is completed, which is indicated by the IsAuthenticating property set to false. This behavior is designed to ensure consistent user experience in real-world applications that leverage authentication over the web service.

For more information on how to customize error style, see Advanced Features in ClientUI Navigation Framework.

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

© 2012 All Rights Reserved.