Silverlight输入数据验证系列四

上一篇，着重介绍了Silverlight客户端同步数据验证机制，演示了IDataErrorInfo接口的实现方法。在一些实际的Silverlight企业级项目中，我们经常会遇到通过服务对数据进行验证，另外应用在验证的同时，不会影响其他功能的运行，也就是我们常提及的异步操作，这样的需求IDataErrorInfo接口和前期我们讨论过的DataAnotation验证机制都无法实现。另外在一些项目中，开发人员会绑定多个错误到一个数据成员，而IDataErrorInfo和DataAnotation也无法实现。Silverlight 4中，微软引入一个新的接口INotifyDataErrorInfo，该接口的实现，可以轻松的解决以上两个问题。

 

INotifyDataErrorInfo接口的概述

INotifyDataErrorInfo接口和IDataErrorInfo相同，命名空间都是System.ComponentModel。

该接口是为数据成员提供自定义的同步或者异步验证支持。最常用的是对异步验证的支持，另外，可支持单属性中绑定多个错误信息。

INotifyDataErrorInfo接口具有一个属性，一个方法，一个事件，分别是：

HasErrors， 这个属性判断当前对象中是否有错误，如果返回True则说明对象出现验证错误，反之则False。

 

方法：

GetErrors， 这个方法负责返回特定验证成员中所有的验证错误信息，如果PropertyName参数为null或者string.empty，该方法将返回一个错误到全局对象中。

 

事件：

ErrorsChanged，该事件与上篇我们提及的PropertyChanged事件相似。当添加，删除，修改验证错误时，将激活该事件通知绑定系统，更新UI。

 

INotifyDataErrorInfo接口实例演示

实现INotifyDataErrorInfo接口，支持服务器端异步验证，所以，本实例将创建一个Web服务，演示该接口验证效果。

 

本篇实例，我们仍旧使用SilverlightValidationDemo项目，为了不和过去的验证方法冲突，这里我们创建一个新的数据成员类Staff，该类实现INotifyDataErrorInfo接口和INotifyPropertyChanged接口. 其默认代码如下，后面我们将逐渐完善这些代码，

 

        #region  INotifyDataErrorInfo Members

         public   event  EventHandler < DataErrorsChangedEventArgs >  ErrorsChanged;

         public  System.Collections.IEnumerable GetErrors( string  propertyName)
        {
             throw   new  NotImplementedException();
        }

         public   bool  HasErrors
        {
             get  {  throw   new  NotImplementedException(); }
        }

         #endregion

         #region  INotifyPropertyChanged Members

         public   event  PropertyChangedEventHandler PropertyChanged;

         #endregion

 

 

另外定义一个新的数据成员，UserName

 

         #region  data memebers
         private   string  _username;
         public   string  UserName
        {
             get  {  return  _username; }
             set
            {
                _username  =  value;
            }
        }

         #endregion

 

 

完成以上的客户端准备步骤，我们首先到Web服务器端创建一个Silverlight enabled WCF Service， ValidationService。 这里我不再演示具体的创建步骤，如果不会创建的，请参考这里：图文详解Silverlight访问MSSQL数据库

 

 

在服务端，我们创建简单的验证代码，如下

 

    [ServiceContract(Namespace  =   "" )]
    [AspNetCompatibilityRequirements(RequirementsMode  =  AspNetCompatibilityRequirementsMode.Allowed)]
     public   class  ValidationService
    {
        [OperationContract]
         public   bool  ValidationUserName( string  username)
        {
             if  (username  ==   " jv9 " )
                 return   true ;
             else
                 return   false ;
        }
    }

 

 

创建完毕后，编译SilverlightValidationDemo.Web项目，然后回到Silverlight客户端，添加一个新的服务引用，

 

 

 

 

 

搜索到刚创建的ValidationService服务，添加到客户端，Visual Studio 2010会自动创建客户端配置文件ServiceReferences.ClientConfig，

 

 

到这里一个WCF服务已经创建成功，下面，修改Staff类，

之前，我们已经创建了新的数据成员UserName，另外执行INotifyDataErrorInfo接口，自动生成ErrorsChanged事件，GetErrors方法和HasErrors属性。

首先，需要对GetErrors方法进行重构，创建全局变量_validationErrors,承载验证错误信息集合.

 

  private  Dictionary < string , ObservableCollection < string >>  _validationErrors;
         public  System.Collections.IEnumerable GetErrors( string  propertyName)
        {
             if  ( ! string .IsNullOrEmpty(propertyName))
            {
                 if  (_validationErrors.ContainsKey(propertyName))
                     return  _validationErrors[propertyName];
                 else
                     return   null ;
            }
             else
                 return  null;
        }

 

 

 然后，对HasErrors属性进行重构，，判断是否有验证错误，

         public   bool  HasErrors
        {
             get  
            {
                 foreach  ( string  key  in  _validationErrors.Keys)
                {
                     if  (_validationErrors[key].Count  >   0 )
                         return   true ;
                }
                 return   false ;
            }
        }

 

 

创建构造函数，和初始化错误集合，

 

         public  Staff()
        {
            _validationErrors  =   new  Dictionary < string , ObservableCollection < string >> ();
            GenerateErrorsCollection( " UserName " );
        }
         #endregion

         #region  private methods
         private   void  GenerateErrorsCollection( string  propertyName)
        {
             if  ( ! _validationErrors.ContainsKey(propertyName))
            {
                _validationErrors.Add(propertyName,  new  ObservableCollection < string > ());
            }
        }

 

 

添加调用服务客户端代码，

 

 

         private   void  ValidateUserNameandPasswordAsync( string  username)
        {
            var client  =   new  ValidationService.ValidationServiceClient();
            client.ValidationUserNameCompleted  +=  (o, e)  =>
            {
                _validationErrors[ " UserName " ].Clear();

                 if  (e.Result)
                {
                    _username  =  username;
                    NotifyPropertyChanged( " UserName " );
                }
                 else
                {
                    _validationErrors[ " UserName " ].Add( " 服务器端返回错误，用户名必须是jv9 " );

                }
                 if  (ErrorsChanged  !=   null )
                {
                    ErrorsChanged( this ,  new  DataErrorsChangedEventArgs( " UserName " ));
                }
            };

            client.ValidationUserNameAsync(username);
        }

 

 

在数据成员中，添加验证方法调用，

 

         #region  data memebers
         private   string  _username;
         public   string  UserName
        {
             get  {  return  _username; }
             set
            {
                _username  =  value;
                ValidateUserNameandPasswordAsync(value);
            }
        }

         #endregion

 

 

其运行效果：

 

 

 

在每次修改用户框内容后，应用会自动向WCF服务请求验证，如果验证失败，则弹出验证错误信息，反之，则继续。

 

INotifyPropertyChanged接口，相比前面介绍的几个验证机制，其复杂程度较高，需要开发人员设计部分代码，但是其异步服务器端数据验证功能和单一属性添加多个错误信息功能，是Silverlight企业级项目中常用到的功能。在随后的项目中，我们会使用更多实例演示其强大功能。

 

今天就到这里了。

 

源代码下载