×
Namespaces

Variants
Actions
(Difference between revisions)

How to use Cimbalino Windows Phone Toolkit UserInfo - UserExtendedPropertiesService

From Nokia Developer Wiki
Jump to: navigation, search
hamishwillee (Talk | contribs)
m (Hamishwillee - Bot update - Fix metadata)
hamishwillee (Talk | contribs)
m (Hamishwillee -)
Line 50: Line 50:
 
Register the service in the {{Icode|ViewModelLocator}} constructor as shown below  
 
Register the service in the {{Icode|ViewModelLocator}} constructor as shown below  
  
<code csharp>
+
<code csharp 1>
/// <summary>
+
 
     /// This class contains static references to all the view models in the
 
     /// This class contains static references to all the view models in the
 
     /// application and provides an entry point for the bindings.
 
     /// application and provides an entry point for the bindings.
    /// </summary>
 
 
     public class ViewModelLocator
 
     public class ViewModelLocator
 
     {
 
     {
        /// <summary>
 
 
         /// Initializes a new instance of the ViewModelLocator class.
 
         /// Initializes a new instance of the ViewModelLocator class.
        /// </summary>
 
 
         public ViewModelLocator()
 
         public ViewModelLocator()
 
         {
 
         {
Line 92: Line 88:
 
   using Cimbalino.Phone.Toolkit.Services;
 
   using Cimbalino.Phone.Toolkit.Services;
  
    /// <summary>
 
 
     /// This class contains properties that the main View can data bind to.
 
     /// This class contains properties that the main View can data bind to.
    /// <para>
 
    /// Use the <strong>mvvminpc</strong> snippet to add bindable properties to this ViewModel.
 
    /// </para>
 
    /// <para>
 
    /// You can also use Blend to data bind with the tool's support.
 
    /// </para>
 
    /// <para>
 
    /// See http://www.galasoft.ch/mvvm
 
    /// </para>
 
    /// </summary>
 
 
     public class MainViewModel : ViewModelBase
 
     public class MainViewModel : ViewModelBase
 
     {
 
     {
        /// <summary>
 
 
         /// The user extended properties service
 
         /// The user extended properties service
        /// </summary>
 
 
         private readonly IUserExtendedPropertiesService _userExtendedPropertiesService;
 
         private readonly IUserExtendedPropertiesService _userExtendedPropertiesService;
  
        /// <summary>
 
 
         /// Initializes a new instance of the MainViewModel class.
 
         /// Initializes a new instance of the MainViewModel class.
        /// </summary>
 
 
         public MainViewModel(IUserExtendedPropertiesService userExtendedPropertiesService)
 
         public MainViewModel(IUserExtendedPropertiesService userExtendedPropertiesService)
 
         {
 
         {
Line 119: Line 100:
 
         }
 
         }
  
        /// <summary>
 
 
         /// Gets the anonymous user identifier.
 
         /// Gets the anonymous user identifier.
        /// </summary>
 
        /// <value>
 
        /// The anonymous user identifier.
 
        /// </value>
 
 
         public string AnonymousUserID
 
         public string AnonymousUserID
 
         {
 
         {

Revision as of 09:55, 26 November 2013

This samples has the goal to show how to use Cimbalino Windows Phone Toolkit UserInfo – UserExtendedPropertiesService.

WP Metro Icon WP8.png
SignpostIcon WP7 70px.png
Article Metadata
Tested with
SDK: Windows Phone 8.0 SDK, Windows Phone 7.1.1. SDK
Devices(s): Lumia 800, Lumia 920
CompatibilityPlatform Security
Capabilities: ID_CAP_IDENTITY_USER
Article
Created: saramgsilva (18 Nov 2013)
Last edited: hamishwillee (26 Nov 2013)

Contents

Introduction

The Cimbalino Windows Phone Toolkit delivers a set of useful and powerful MVVM-compatible tools and services to help developers build Silverlight applications for Windows Phone. The Toolkit is divided in projects which deliver different features, ranging from base MVVM services and helpers, through to code for background agents, and for accessing media library, location services etc. Cimbalino.Phone.Toolkit.UserInfo is a MVVM compatible services for user information access.

IUserExtendedPropertiesService - Represents an interface for a service capable of obtaining an anonymous identifier for the user of the device.The implementation is UserExtendedPropertiesService.

This article explains how to use the service in an MVVM Light app. Developers should first read How to use MVVM Light Toolkit for Windows Phone for a general overview of MVVM Light and how to use services.


Building the example code

The source code for the code example is available here: (github).

To build the source code you will also need the MVVM Light Toolkit and the Cimbalino Windows Phone Toolkit. Their packages are available in the Nuget Package Manager. For more details see:


The sample is built using MVVM Light and the article does not go into great detail about the plumbing/infrastructure provided by the toolkit. For more information see:


Note.pngNote: you must specify the following capabilities in the app manifest: ID_CAP_IDENTITY_USER

Registering the service

Register the service in the ViewModelLocator constructor as shown below

  1.     /// This class contains static references to all the view models in the
  2.     /// application and provides an entry point for the bindings.
  3.     public class ViewModelLocator
  4.     {
  5.         /// Initializes a new instance of the ViewModelLocator class.
  6.         public ViewModelLocator()
  7.         {
  8.             ServiceLocator.SetLocatorProvider(() => SimpleIoc.Default);
  9.  
  10.             SimpleIoc.Default.Register<IUserExtendedPropertiesService, UserExtendedPropertiesService>();
  11.  
  12.             SimpleIoc.Default.Register<MainViewModel>();
  13.         }
  14.  
  15.         public MainViewModel MainViewModel
  16.         {
  17.             get
  18.             {
  19.                 return ServiceLocator.Current.GetInstance<MainViewModel>();
  20.             }
  21.         }
  22.  
  23.         public static void Cleanup()
  24.         {
  25.             // TODO Clear the ViewModels
  26.         }
  27.     }


Implementing the ViewModel

Then we should implement the MainViewModel as following:

  using Cimbalino.Phone.Toolkit.Services;
 
/// This class contains properties that the main View can data bind to.
public class MainViewModel : ViewModelBase
{
/// The user extended properties service
private readonly IUserExtendedPropertiesService _userExtendedPropertiesService;
 
/// Initializes a new instance of the MainViewModel class.
public MainViewModel(IUserExtendedPropertiesService userExtendedPropertiesService)
{
_userExtendedPropertiesService = userExtendedPropertiesService;
}
 
/// Gets the anonymous user identifier.
public string AnonymousUserID
{
get
{
return _userExtendedPropertiesService.AnonymousUserID;
}
}
}


Implementing the View

Add the binding in main page like:

DataContext="{Binding MainViewModel, Source={StaticResource Locator}}"

The MainPage.xaml can be the following:

<phone:PhoneApplicationPage x:Class="CimbalinoSample.MainPage"
xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
xmlns:phone="clr-namespace:Microsoft.Phone.Controls;assembly=Microsoft.Phone"
xmlns:shell="clr-namespace:Microsoft.Phone.Shell;assembly=Microsoft.Phone"
DataContext="{Binding MainViewModel,
Source={StaticResource Locator}}"

FontFamily="{StaticResource PhoneFontFamilyNormal}"
FontSize="{StaticResource PhoneFontSizeNormal}"
Foreground="{StaticResource PhoneForegroundBrush}"
Orientation="Portrait"
SupportedOrientations="Portrait"
shell:SystemTray.IsVisible="True"
mc:Ignorable="d">
 
<!-- LayoutRoot is the root grid where all page content is placed -->
<Grid x:Name="LayoutRoot" Background="Transparent">
<Grid.RowDefinitions>
<RowDefinition Height="Auto" />
<RowDefinition Height="*" />
</Grid.RowDefinitions>
 
<!-- TitlePanel contains the name of the application and page title -->
<StackPanel x:Name="TitlePanel"
Grid.Row="0"
Margin="12,17,0,28">
<TextBlock Margin="12,0"
Style="{StaticResource PhoneTextTitle2Style}"
Text="Cimbalino Sample" />
<TextBlock Margin="9,-7,0,0"
Style="{StaticResource PhoneTextTitle2Style}"
Text="UserExtendedPropertiesService" />
</StackPanel>
 
<!-- ContentPanel - place additional content here -->
<Grid x:Name="ContentPanel"
Grid.Row="1"
Margin="12,0,12,0" >
<TextBlock TextWrapping="Wrap">Anonymous User ID : <Run Text="{Binding AnonymousUserID}"/></TextBlock>
</Grid>
 
</Grid>
 
</phone:PhoneApplicationPage>
134 page views in the last 30 days.