Silverlight渐进学习系列(1)——IValueConverter的使用

 

背景

本文通过一个简单的按钮权限来描述如何使用IValueConverter接口。

首先可以看到IValueConverter包含两个接口方法：

object Convert(object value, Type targetType, object parameter, CultureInfo culture);

以及

object ConvertBack(object value, Type targetType, object parameter, CultureInfo culture);

实现了源数据类型以及目标数据类型之间的转换。

 

详细分析

1. 该按钮权限分为4种状态：查询，修改，添加，删除；用户的权限可以是4种状态中的任意组合；

比如3级用户只拥有查询的权限；2级用户拥有查询和修改的权限；超级管理员拥有所有状态的权限；

UI上的显示很简单，如果有权限，按钮则显示；无权限，按钮就不显示；

 

2. 有些人考虑这个问题的时候，可能会想到在数据库设计这个权限的时候，会使用字符串形式，如“1”表示拥有查询权限，“1,3”表示拥有查询和添加权限，“1,2,3,4”表示拥有所有权限。而我这里考虑是采用位运算的方式进行处理；考虑到4种状态，我先创建一个用户权限枚举类型

代码

///   <summary>  
///  用户权限 
///   </summary>  
public   enum  UserRight 
{ 
    None  =   0 , 

     ///   <summary>  
     ///  查询权限（1） 
     ///   </summary>  
    Select  =   1 , 

     ///   <summary>  
     ///  修改权限（2） 
     ///   </summary>  
    Update  =   2 , 

     ///   <summary>  
     ///  插入权限（3） 
     ///   </summary>  
    Insert  =   3 , 

     ///   <summary>  
     ///  删除权限（4） 
     ///   </summary>  
    Delete  =   4  
}

 根据4种状态的组合，可以得到15种情况的组合；所以通过1—15整型数值，可以对应每一种的组合情况，这样可以通过一个枚举扩展方法进行实现：

代码

///   <summary>  
///  将复合权限类型ID 转换成 权限枚举类型数组 
///   </summary>  
///   <param name="userRightComplex"></param>  
///   <returns></returns>  
public   static  UserRight[] ToUserRightArray( this   int  userRightComplex) 
{ 
     int  max  =  EnumHelper.GetValues( typeof (UserRight)).Length  -   2 ;  // 除去None枚举，并需要再减1，所以减2 

    List < UserRight >  userRightList  =   null ; 
     while  (userRightComplex  >   0 ) 
    { 
         if  (userRightList  ==   null ) 
            userRightList  =   new  List < UserRight > (); 

         int  arg  =  Convert.ToInt32(Math.Pow( 2 , max)); 
         if  (userRightComplex  >=  arg) 
        { 
            userRightComplex  -=  arg; 
            userRightList.Add((UserRight)Enum.Parse( typeof (UserRight), (max  +   1 ).ToString(),  true )); 
        } 
        max -- ; 
    } 
     if  (userRightList  ==   null   ||  userRightList.Count  ==   0 ) 
    { 
         return   null ; 
    } 
     return  userRightList.ToArray(); 
}

这样，通过一个整型值可以得到一个用户权限的数组。

如1得到一个“查询”数组，5得到一个“查询、添加”数组，15得到所有状态的数组；

这样做的目的是为了对于用户权限表可以减少数据库数据存储量，以及能够提高数据库查询的性能；

 

3. 添加一个UserRightControl类，用于用户数据传递：

代码

public   class  UserRightControl 
{ 
     ///   <summary>  
     ///  复合权限类型ID 
     ///   </summary>  
     public   int  UserRightComplex {  get ;  set ; } 

     ///   <summary>  
     ///  权限数组 
     ///   </summary>  
     private  UserRight[] _rights; 
     public  UserRight[] UserRights 
    { 
         get  
        { 
             if  (_rights  ==   null ) 
            { 
                 // 将复合权限类型ID 转换成 权限枚举类型数组 
                _rights  =  UserRightComplex.ToUserRightArray(); 
            } 
             return  _rights; 
        } 
    } 
}

 

4. 创建一个继承于IValueConverter接口的UserRightConverter

代码

public   class  UserRightConverter : IValueConverter 
{ 
     public   object  Convert( object  value, Type targetType,  object  parameter, CultureInfo culture) 
    { 
        Visibility visibility  =  Visibility.Collapsed; 
        UserRight[] rightArray  =  (UserRight[])value; 
        UserRight right  =  (UserRight)Enum.Parse( typeof (UserRight), ( string )parameter,  true ); 

        UserRight state  =  rightArray.FirstOrDefault(o  =>  o  ==  right); 
         if  (state  !=  UserRight.None) 
        { 
            visibility  =  Visibility.Visible; 
        } 
         return  visibility; 
    } 

     public   object  ConvertBack( object  value, Type targetType,  object  parameter, CultureInfo culture) 
    { 
         throw   new  NotImplementedException(); 
    } 
}

其中value是作为一个用户权限数组绑定过来的，parameter作为对应按钮的属性参数，如果value包含了parameter，该按钮就显示。

 

5. 接着，创建一个UserRightButton.xaml的用户权限按钮控件：

代码

< UserControl  x:Class ="SilverlightAppDemo.UserRightButton"  
    xmlns ="http://schemas.microsoft.com/winfx/2006/xaml/presentation%22 
    xmlns:x=" http://schemas.microsoft.com/winfx/2006/xaml%22 
    xmlns:uc ="clr-namespace:SilverlightAppDemo" >  
     < UserControl.Resources >  
             < uc:UserRightConverter  x:Key ="userRightConverter"   />  
         < Style  x:Key ="userright"  TargetType ="Button" >  
             < Setter  Property ="Height"  Value ="30" />  
             < Setter  Property ="Width"  Value ="60" />  
             < Setter  Property ="FontSize"  Value ="14" />  
         </ Style >  
     </ UserControl.Resources >  
     < StackPanel  HorizontalAlignment ="Left" >  
         < StackPanel  Orientation ="Horizontal" >  
             < Button  Content ="查询"  Visibility ="{Binding UserRights, Converter={StaticResource userRightConverter}, ConverterParameter=Select}"  Style ="{StaticResource userright}" ></ Button >  
             < Button  Content ="修改"  Visibility ="{Binding UserRights, Converter={StaticResource userRightConverter}, ConverterParameter=Update}"  Style ="{StaticResource userright}" ></ Button >  
             < Button  Content ="添加"  Visibility ="{Binding UserRights, Converter={StaticResource userRightConverter}, ConverterParameter=Insert}"  Style ="{StaticResource userright}" ></ Button >  
             < Button  Content ="删除"  Visibility ="{Binding UserRights, Converter={StaticResource userRightConverter}, ConverterParameter=Delete}"  Style ="{StaticResource userright}" ></ Button >  
         </ StackPanel >  
     </ StackPanel >  
</ UserControl >

该用户控件用于权限按钮的UI显示，注意到Button的Visibility属性，Binding UserRight 绑定了 UserRightControl类中的UserRights的权限数组；Converter={StaticResource userRightConverter} 将以userRightConverter为Key的UserRightConverter类 作为按钮的转换器，ConverterParameter后面的值为parameter。

 

6. 最后，在Page.xaml上添加用户权限按钮控件：

代码

< UserControl  x:Class ="SilverlightAppDemo.Page"  
    xmlns ="http://schemas.microsoft.com/winfx/2006/xaml/presentation%22 
    xmlns:x=" http://schemas.microsoft.com/winfx/2006/xaml%22 
    xmlns:uc ="clr-namespace:SilverlightAppDemo" >  
     < UserControl.Resources >  
         < uc:UserRightControl  UserRightComplex ="1"  x:Key ="urControl"   />  
     </ UserControl.Resources >  
     < StackPanel >  
         < uc:UserRightButton  x:Name ="btnUserRight"  DataContext ="{StaticResource urControl}" />  
     </ StackPanel >  
</ UserControl >

其中UserRightButton中的DataContext属性绑定了以urControl为Key的UserRightControl。

 

7. 运行下程序

当UserRightComplex为1时，

 

当UserRightComplex为5时，

当UserRightComplex为15时，

本文主要介绍如何使用IValueConverter在应用场景中，欢迎继续交流。

源代码下载：SilverlightAppDemo.rar