您可能经常需要检查用户输入到 windows 窗体中的信息是否有效。例如,如果您有一个电话号码的 textbox 控件,则可以检查该控件是否只包含适当的字符(数字、括号和连字符等等)。通常,可使用正则表达式验证用户输入的数据。
了解validating之前,我们还需要了解焦点事件的顺序:
焦点事件按下列顺序发生:
- enter //进入控件时发生
- gotfocus //在控件接收焦点时发生
- leave //输入焦点离开控件时发生
- validating //控件数据效验时发生
- validated //数据效验完成后发生
- lostfocus //失去焦点时发生
如果 causesvalidation 属性设置为 false,则将取消 validating 和 validated 事件。
注:gotfocus 和 lostfocus 事件是关联于 wm_killfocus 和 wm_setfocus windows 消息的低级别焦点事件。应对所有控件使用 enter 和 leave 事件。
如果在 validating 事件委托中,canceleventargs 对象的 cancel 属性设置为 true,则正常情况下将在 validating 事件之后发生的所有事件均被取消。
在操作中验证
要验证控件的内容,可以编写代码来处理 validating 事件。在事件处理程序中,测试特定的条件(例如上面的电话号码)。验证是在处理时发生的一系列事件之一。
如果测试失败,则 validating 事件的 canceleventargs 的 cancel 属性将设置为 true。这将取消 validating 事件,并导致焦点返回到控件(juky_huang注:这样会出现一个死循环,除非数据效验通过,可以使用下面强制方法来关闭)。实际的结果是,除非数据有效,否则用户将无法退出该控件。
关闭窗体和重写验证
当数据无效时,维护焦点的控件的副作用是,使用关闭窗体的任何常规方法都将无法关闭父窗体:
- 单击“关闭”框
- 通过右击标题栏显示的“系统”菜单
- 以编程方式调用 close 方法
不过,在某些情况下,无论控件中的值是否有效,您都希望用户可以关闭窗体。您可以重写验证,并通过创建窗体的 closing 事件的处理程序来关闭仍包含无效数据的窗体。在该事件中,将 cancel 属性设置为 false。这将强制关闭该窗体。
注意 如果使用此方法强制关闭窗体,控件中尚未保存的任何信息都将丢失。
注意 模式窗体在关闭时不会验证控件内容。您仍可以使用控件验证将焦点锁定到控件,但不必考虑关闭窗体的行为。
以下是事例代码:
using system;
using system.drawing;
using system.collections;
using system.componentmodel;
using system.windows.forms;
using system.data;
namespace msdnvalidatingex
{
/// <summary>
/// form1 的摘要说明。
/// </summary>
public class form1 : system.windows.forms.form
{
private system.windows.forms.textbox textbox1;
private system.windows.forms.errorprovider errorprovider1;
/// <summary>
/// 必需的设计器变量。
/// </summary>
private system.componentmodel.container components = null;
public form1()
{
//
// windows 窗体设计器支持所必需的
//
//
// todo: 在 initializecomponent 调用后添加任何构造函数代码
//
initializecomponent();
textbox1.validating+=new canceleventhandler(textbox1_validating); //给textbox1添加效验函数
textbox1.validated+=new eventhandler(textbox1_validated);
}
private void textbox1_validating(object sender,canceleventargs e)
{
string errormsg;
if(!validemailaddress(this.textbox1.text,out errormsg))
{
//如果效验没有通过取消后继事件,即validated,lostfocus
e.cancel=true;
this.textbox1.select(0,this.textbox1.text.length);
this.errorprovider1.seterror(this.textbox1,errormsg);
}
}
private void textbox1_validated(object sender,eventargs e)
{
errorprovider1.seterror(this.textbox1,””);
}
public bool validemailaddress(string emailaddress,out string errormessage)
{
//首先判断是否为空,然后判断是否有@,.符号
if(emailaddress.length==0)
{
errormessage=”e-mail address is required.”;
return false;
}
//是否包含@
if(emailaddress.indexof(“@”)>-1)
{
//从@往后面开始搜索,找到.的位置,如果位置大于@的位置说明格式正确
if(emailaddress.indexof(“.”,emailaddress.indexof(“@”))>emailaddress.indexof(“@”))
{
errormessage=””;
return true;
}
}
errormessage=”e-mail address must be valid e-mail address format.\n”+”for example someone@example.com”;
return false;
}
/// <summary>
/// 清理所有正在使用的资源。
/// </summary>
protected override void dispose( bool disposing )
{
if( disposing )
{
if (components != null)
{
components.dispose();
}
}
base.dispose( disposing );
}
#region windows 窗体设计器生成的代码
/// <summary>
/// 设计器支持所需的方法 – 不要使用代码编辑器修改
/// 此方法的内容。
/// </summary>
private void initializecomponent()
{
this.textbox1 = new system.windows.forms.textbox();
this.errorprovider1 = new system.windows.forms.errorprovider();
this.suspendlayout();
//
// textbox1
//
this.textbox1.location = new system.drawing.point(72, 88);
this.textbox1.name = “textbox1”;
this.textbox1.tabindex = 0;
this.textbox1.text = “”;
//
// errorprovider1
//
this.errorprovider1.containercontrol = this;
//
// form1
//
this.autoscalebasesize = new system.drawing.size(6, 14);
this.clientsize = new system.drawing.size(292, 273);
this.controls.add(this.textbox1);
this.name = “form1”;
this.text = “form1”;
this.resumelayout(false);
}
#endregion
/// <summary>
/// 应用程序的主入口点。
/// </summary>
[stathread]
static void main()
{
application.run(new form1());
}
}
}