Windows Workflow HOL学习笔记（七）：添加一个验证来检查Email参数

本文内容来自Microsoft Hands-on Labs for Windows Workflow Foundation中的HOL02中的第三个练习，其中包括两个任务：

添加一个验证来检查Email参数。

Ø         添加一个Email验证的Code Activity

Ø         测试这个验证

 

这个练习中，将扩展练习2中的项目，验证发送邮件地址的属性内容Email格式是否正确。

Designer：这个组件定义了workflow中的activity和custom activity设计的直观表示。

Code generator：这是一个扩展，用来生成工作流中activity的自定义代码。InvokeWebService这个开箱即用的activity就是这样。

Validator：这个组件增强了设计时和运行时的activity符号。

Toolbox item：定义了activity在Visual Studio的设计环境中，在工具箱中显示的自定义行为。

Executor：这是一个无状态的组件，用来执行activity的execution semantics。这个组件不会在简单的情况下定义，例如前面一个练习的情况下才会被覆写。

Serializer：如果需要提供自定义的序列化行为。

Deployer：当工作流包含activity，运行代码时将部署到主环境中。

 

1．在解决方案资源管理器中，在SendMailActivityLibrary中添加一个Code File，名字为ParametersValidator.cs。

2．添加如下代码来建立适当的继承关系。ActivityValidator类包含设计时和运行时的验证逻辑来确保activity被适当的配置。自定义的验证类继承自ActivityValidator还是CompositeActivityValidator基类，依赖于你的activity是一个基本的还是一个复合的。在工作流编译的时候和运行时，当activity动态更新执行时自动执行验证。

using System;

using System.Collections.Generic;

using System.Text;

using System.Workflow.Activities;

using System.Workflow.ComponentModel;

using System.Workflow.ComponentModel.Compiler;

using System.Text.RegularExpressions;

using System.Net.Mail;

 

namespace SendMailActivityLibrary

{

    public class ParametersValidator : ActivityValidator

    {

    }

}

3．覆写ValidateProperties方法，这样我们可以在自定属性上执行自定义验证。Activity的ValidateProperties方法主要用来校验Activity属性的编译语法。这个验证组件将检查Email地址是否为正确的格式。

        public override ValidationErrorCollection ValidateProperties(ValidationManager manager, object obj)

        {

            ValidationErrorCollection validationErrors = new ValidationErrorCollection(base.ValidateProperties(manager, obj));

 

            SendMailActivity sendMailActivityToBeValidated = obj as SendMailActivity;

 

            if (sendMailActivityToBeValidated == null)

            {

                throw new InvalidOperationException("Parameter obj is not of type SendMailActivity");

            }

 

            if (!IsValidEmailAddress(sendMailActivityToBeValidated.To))

            {

                ValidationError CustomActivityValidationError = new ValidationError(String.Format("\'{0}\' is an Invalid destination e-mail address", sendMailActivityToBeValidated.To), 1);

 

                validationErrors.Add(CustomActivityValidationError);

            }

 

            if (!IsValidEmailAddress(sendMailActivityToBeValidated.From))

            {

                ValidationError CustomActivityValidationError = new ValidationError(String.Format("\'{0}\' is an Invalid source e-mail address", sendMailActivityToBeValidated.From), 1);

 

                validationErrors.Add(CustomActivityValidationError);

            }

 

            return validationErrors;

        }

4．你会注意到里面调用了一个方法叫IsValidEmailAddress。这是验证部分的引擎，它检查字符串是否为一个有效的Email地址。

        public Boolean IsValidEmailAddress(string address)

        {

            // must only proceed with validation if we have data   

            // to validate

            if (address == null || address.Length == 0)

                return true;

 

            Regex rx = new Regex(@"[^A-Za-z0-9@\-_.]", RegexOptions.Compiled);

            MatchCollection matches = rx.Matches(address);

 

            if (matches.Count > 0)

                return false;

 

            // Must have an '@' character

            int i = address.IndexOf('@');

 

            // Must be at least three chars after the @

            if (i <= 0 || i >= address.Length - 3)

                return false;

 

            // Must only be one '@' character

            if (address.IndexOf('@', i + 1) >= 0)

                return false;

 

            // Find the last . in the address

            int j = address.LastIndexOf('.');

 

            // The dot can't be before or immediately after the @ char

            if (j >= 0 && j <= i + 1)

                return false;

 

            return true;

        }

5．查看SendMailActivity代码。把ActivityValidator加到SendMailActivity上。

    [ActivityValidator(typeof(ParametersValidator))]

    public partial class SendMailActivity : System.Workflow.ComponentModel.Activity

6．生成解决方案。

任务一完成。

 

7．打开SendMailWorkflow设计视图。选中SendMailActivity。在From属性中输入一个不正确的Email地址。

8．在设计视图上，SendMailActivity右上角会出现一个红色的叹号，将鼠标放在上面会看到验证后的错误提示。
   

9．修改后，Email地址验证通过，错误提示会消失。

10．保存文件，编译生成解决方案。

任务二完成。

参考资料：

Microsoft Hands-on Labs for Windows Workflow Foundation