Infopath是微软Office办公软件家族中的成员之一,它主要的功能是面向客户端收集XML数据,并按照预期定义的格式生成XML文件,它以可视化表单的形式收集数据,并且支持C#编程接口以及外部数据源等。Infopath的使用避免了最终用户以完全手写的方式生成XML数据文件,同时也可以统一XML文件的格式,在MOSS系统和网站开发中被广泛使用。
使用Infopath开发一个XML前端表单页面需要有几个特定的步骤,如编写XML示例文件,生成XML Schema文件,在Infopath中导入主数据源,设计Infopath表单呈现,如果需要还可以给表单添加C#事件代码,如表单打开、保存时所要执行的动作,附加按钮的执行动作等。读者如果对Infopath的开发有兴趣可以单独去研究,本文主要介绍在Infopath中如何实现数据的有效性验证。
在Infopath中,有三种方法可以实现数据的有效性验证:
1. 使用Infopath的内置数据类型。
2. 给输入项添加自定义数据验证条件或验证事件。
3. 通过给表单自定义按钮添加规则或验证事件来进行数据有效性验证。
使用Infopath内置数据类型进行数据的自动验证
这是最简单的数据验证方法。在Infopath中添加控件,或给主数据源中的域指定控件的时候,可以为控件的输入指定数据类型。如果没有为Infopath指定单独的主数据源,那么Infopath将按照你在表单中添加的控件来构建数据源结构;如果在表单编辑之前已经指定了主数据源,则控件所接受的数据类型依赖于它所绑定的数据源中域的数据类型,数据源中域的数据类型可在编写XML Schema文件时单独指定,如果没有指定,默认为String类型,表示可接受任何类型的数据。
使用自定义数据验证条件或验证事件进行数据有效性验证
你可以在Infopath中设置自定义数据验证条件或编写自定义事件进行数据的有效性验证,这需要一些额外的编程开销或计算机编程方面的知识。
1. 使用自定义数据验证条件
右键单击要设置数据有效性验证的控件,点击“属性”,或者直接双击该控件,在弹出的对话框中点击“数据验证”按钮,在弹出的对话框中点击“添加”,在数据验证对话框中设置数据验证条件,并填写当数据验证失败时屏幕的提示信息以及警告对话框要显示的消息内容。
Infopath已经集成了很多数据验证条件方便用户直接选择,如域中的值大于、小于、等于、包含、不包含等等,如果你想定义自己的匹配模式,可以选择“匹配模式”或“不匹配模式”,然后在第三个下拉列表中选择“选择模式”,在弹出的对话框中编写自定义模式正则表达式。例如你想规定该域只能接受包含小数点的数字,你可以编写如下正则:
- -?[0-9]*\.?[0-9]+
然后设置警告信息:
2. 使用自定义验证事件
使用自定义验证事件需要编写C#代码进行数据的有效性验证,因为Infopath内置了VSTA编程接口,使得我们可以非常方便地通过Visual Studio为Infopath编写C#代码以完成一些特定的功能。在这里要注意一下,编写本文时我本机的开发环境是Visual Studio 2008 + Office 2007,在安装Office 2007时必须手动将Infopath项下的VSTA选项勾上,否则Infopath默认是不支持VSTA编程接口的。Infopath中的VSTA默认使用的Visual Studio 2005的开发环。
右键单击要设置数据有效性验证的控件,选择“编程”-“Validating事件”,此时Infopath会联系Visual Studio打开VSTA工程,在VSTA工程中,我们可以为事件添加自定义方法。有一个地方需要说明,默认情况下Infopath会以VB.NET语言创建VSTA工程,如果你想更改工程语言,可以点击“工具”-“选项”,在“设计”选项卡中将语言选为C#,同时你还可以设置工程的默认保存位置。如果之前你已经创建了VB.NET语言的VSTA工程,可以通过“工具”-“表单选。
我们在VSTA中添加如下代码,以实现我们在上例中限制只接受数字类型的数据验证效果。
- public void field1_Validating(object sender, XmlValidatingEventArgs e)
- {
- if (!e.UndoRedo && e.Operation == XmlOperation.ValueChange)
- {
- // 获取数据源中域的值
- XPathNavigator root = MainDataSource.CreateNavigator();
- string field1 = root.SelectSingleNode("//my:field1", NamespaceManager).Value;
- // 检查用户输入项是否匹配正则表达式
- System.Text.RegularExpressions.Regex regEx = new System.Text.RegularExpressions.Regex(@"-?[0-9]*\.?[0-9]+");
- if (!regEx.IsMatch(field1))
- {
- e.ReportError(e.Site, true, "仅允许数字");
- }
- }
- }
保存代码并关闭Visual Studio,保存或发布编写好的Infopath表单,然后直接打开表单实例,在所要验证的域中输入内容,当验证失败时Infopath会按照验证事件代码中的要求弹出相应的提示。
在按钮上使用规则或验证事件进行数据有效性验证
在Infopath中,除了上面介绍的两种方法可以实现数据的有效性验证外,我们还可以通过给表单上的按钮设置规则及验证事件来验证域的数据有效性。
1. 使用规则进行数据有效性验证
例如表单中有一个文本框,一个表达式框和一个按钮,我们想验证用户在文本框中输入的值是否为一个数字,并且将信息显示在表达式框中。按照下面的步骤给按钮添加规则:
当用户打开表单实例时,在文本框中输入非数字,然后点击按钮,此时表达式框中会出现相应提示;如果用户输入的内容符合验证规则,则表达式框中的内容被清空。
2. 在按钮上使用验证事件进行数据有效性验证
右键单击按钮点击“属性”,或者直接双击按钮,在“属性”对话框中点击“编辑表单代码”,在VSTA工程代码中已经新添加了一个按钮事件,添加下面的代码:
- public void CTRL2_5_Clicked(object sender, ClickedEventArgs e)
- {
- // 获取表单数据源根节点的引用
- XPathNavigator root = MainDataSource.CreateNavigator();
- // 清空表达式框中的内容
- root.SelectSingleNode("my:field2", NamespaceManager).SetValue("");
- // 检查文本框中的值是否为数字,并且在表达式框中显示提示信息
- string field1 = root.SelectSingleNode("my:field1", NamespaceManager).Value;
- System.Text.RegularExpressions.Regex regEx = new System.Text.RegularExpressions.Regex(@"-?[0-9]*\.?[0-9]+");
- if (!regEx.IsMatch(field1))
- {
- root.SelectSingleNode("//my:field2", NamespaceManager).SetValue("仅允许数字");
- }
- }
注意:在Infopath中,所有的数据验证仅会给出相应的提示信息,用户可以强制保存表单并忽略数据有效性验证的提示信息。另外,本文C#代码中所使用的主数据源节点名称(如my:field1,my:field2等)因实际情况而异。