C#"焦点事件"中的Validating处理方法

您可能经常需要检查用户输入到 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 &#39;someone@example.com&#39;\";
  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());
}
}
}