C#自定义控件-事件-委托

最新推荐文章于 2024-08-09 09:00:13 发布

左脑

最新推荐文章于 2024-08-09 09:00:13 发布

阅读量4k

点赞数 2

分类专栏： C#自定义控件

C#自定义控件专栏收录该内容

2 篇文章 0 订阅

订阅专栏

在组件编程中对事件的理解是十分重要的，C# 中的“事件”是当对象发生某些有趣的事情时，类向该类的客户提供通知的一种方法。与事件联系最为紧密的，个人认为是委托.委托可以将方法引用封装在委托对象内。为了弄清组件-事件-委托三者的关系，本人用实际的例子来谈谈自己的理解。

理解C#编程中的组件-事件-委托

首先创建一个Windows控件项目，添加如下控件样板：

当事件触发时，会传递一个EventArgs类型的参数给事件处理方法，为了能传递自定义的信息，我们可以创建一个继承于EventArgs的事件参数类，其定义如下:

 
 public class EventLoginArgs:System.EventArgs  
{  
public string strUserID;  
public string strUserName;  
public string strUserPWD;  
public bool bVaild;  
public EventLoginArgs(
string userID，string userName，string userPWD)  
{  
strUserID = userID;  
strUserName = userName;  
strUserPWD = userPWD;   
}

再声明两个委托，它们是对EventLoginArgs和EventArgs对象中的信息的封装，如下:

 
 public delegate void UserLoginEventHandler(
object sender，EventLoginArgs e);  
public delegate void CancelEventHandler(
object sender，EventArgs e);

在组件中为了能让用户自定义某事件的处理方法，所以组件必需提供事件接口.如果只是继承于单个已有的Windows控件，可以重载已知的方法进行添加自己的处理，也可以声明自定义的事件接口.而若组件中包含多个控件，应该根据实际需要声明事件接口，此处本人就两个按钮的使用而声明两个自定义的事件接口，如下:

 
 public event UserLoginEventHandler SubmitLogin;  
public event CancelEventHandler Cancel;  
protected virtual void OnSubmitLogin(EventLoginArgs e)  
{  
if(this.SubmitLogin!=null)  
{   
SubmitLogin(this，e);  
}  
 
}  
protected virtual void OnCancel(EventArgs e)  
{  
if(this.Cancel!=null)  
{  
Cancel(this，e);  
}

其实SubmitLogin 是UserLoginEventHandler委托的实例，令人费解的是此事件的触发，传递，处理过程如何呢?

在本例中是通过确定按钮来触发submitLogin事件的：

 
 private void btnOK_Click(object sender， System.EventArgs e)  
{   
if(txtID.Text != ""&&txtName.Text !=""&&txtPWD.Text !="")  
{  
intLoginTime++;  
OnSubmitLogin(new EventLoginArgs(
txtID.Text，txtName.Text，txtPWD.Text));  
bLogin = TestUserInDB(new EventLoginArgs(
txtID.Text，txtName.Text，txtPWD.Text));  
MessageBox.Show(
"this is the btnOK_click function!"，
"In control"，MessageBoxButtons.OK);  
if(!bLogin)  
MessageBox.Show(
"Login in Failed!"，"Login Error"，
MessageBoxButtons.OK);  
}  
else 
{  
MessageBox.Show(
"Your must input all the items!"，"Login Info"，
MessageBoxButtons.OK);  
}  
}

注意本例中的对话框是为了帮助了解事件的过程，真正有用的是第二个例子。

在btnOK_Click事件响应中，先对进行简单的有效性检查，建议实际工作应作加强完善.intLoginTime变量是尝试登录的次数.TestUserInDB是通过已知信息在数据库中搜索出有关记录进行判断用户是否合法. 因为组件的测试是通过客户程序的，所以应该创建一个最简单明了的客户程序.这是一个Windows应用程序，将编译好的组件添加到用户控件栏中，拖出到工作区中，添加SubmitLogin事件的响应程序，如下:

 
 private void userControl1_SubmitLogin(
object sender， Userlogin.EventLoginArgs e)  
{  
MessageBox.Show("This is in test form!"+ 
userControl1.bLogin +
  "\ns Login times is "+userControl1.intLoginTime +
"\ne's strUserID="+e.strUserID，"Test"，
MessageBoxButtons.OK);  
}

此时运行客户程序可得以下结果:

 
 This is in test form!  
this is the process in DB  
this is the btnOK_click function!

结果表明单击btnOK按钮时执行组件中的OnSubmitLogin(new EventLoginArgs(txtID.Text，txtName.Text，txtPWD.Text))，此方法又调用 SubmitLogin(this，e)，从而激发SubmitLogin事件，userControl1_SubmitLogin就进行响应，故打印第一行。

跟着是执行TestUserInDB，它打印出第二行。

最后是返回到btnOK_Click中输出最后一行。

C#编程中的组件-事件-委托：例子二

注意若btnOK_Click中的OnSubmitLogin和TestUserInDB所在的行调换位置，其结果是不同的.第二个例子中，二者的位置调换，先进行数据库查询判断，再在SubmitLogin的事件响应userControl1_SubmitLogin中处理结果，下面的是例子二的主要代码:

 
 public delegate void UserLoginEventHandler(
object sender，EventLoginArgs e);  
public delegate void CancelEventHandler(
object sender，EventArgs e);  
 
public event UserLoginEventHandler SubmitLogin;  
public event CancelEventHandler Cancel;  
 
protected virtual void OnSubmitLogin(EventLoginArgs e)  
{  
if(this.SubmitLogin!=null)  
{   
SubmitLogin(this，e);  
}  
 
}  
protected virtual void OnCancel(EventArgs e)  
{  
if(this.Cancel!=null)  
Cancel(this，e);  
}  
public string Server  
{  
}  
public string DataBase  
{  
}  
public string TableSet  
{  
}  
public string UserForDB  
{  
}  
public string PWDForDB  
{  
}  
 
public bool TestUserInDB(EventLoginArgs e)  
{    
//MessageBox.Show(
  //"this is the process for DB!"，
//"TestUserInDB"，MessageBoxButtons.OK);  
bool bOK = false;  
if(this.strDataBase!=null && 
this.strServer!=null && 
this.strUserForDB!=null)  
{   
if(this.strPWDForDB==null)  
this.strPWDForDB = "";  
 
string strConnection = "server="+this.strServer +
";database="+this.strDataBase +";UID="+this.strUserForDB +
";PWD="+this.strPWDForDB;  
string strSQL = "select UserID，UserName，UserPWD from "+
this.strTableSet+" where UserID='"+e.strUserID+
"' and UserName='"+e.strUserName +
"' and UserPWD='"+e.strUserPWD+"'";  
SqlConnection conn = new SqlConnection(strConnection);  
try 
{  
conn.Open();  
}  
catch(SqlException ex)  
{  
MessageBox.Show(
"数据库不能打开!请检查有关参数."，
"Error"，MessageBoxButtons.OK);  
return false;  
}  
SqlDataAdapter da = new SqlDataAdapter(strSQL，conn);  
DataSet ds = new DataSet();  
try 
{  
da.Fill(ds，this.strTableSet);  
}  
catch(SqlException ex)  
{  
......  
}  
foreach(DataRow row in ds.Tables[this.strTableSet].Rows)  
{  
if(row != null)  
{  
bOK = true;   
}  
 
}  
.......  
}  
else 
{  
bOK = false;  
}  
return bOK;  
}  
private void btnOK_Click(object sender， System.EventArgs e)  
{   
if(txtID.Text != ""&&txtName.Text !=""&&txtPWD.Text !="")  
{  
intLoginTime++;  
bLogin = TestUserInDB(new EventLoginArgs(
txtID.Text，txtName.Text，txtPWD.Text));  
if(!bLogin)  
MessageBox.Show(
"Login in Failed!"，"Login Error"，
MessageBoxButtons.OK);  
else 
OnSubmitLogin(new EventLoginArgs(
txtID.Text，txtName.Text，txtPWD.Text));  
}  
else 
{  
MessageBox.Show(
"Your must input all the items!"，
"Login Info"，MessageBoxButtons.OK);  
}  
}   
 
private void btnCancel_Click(
object sender， System.EventArgs e)  
{  
OnCancel(e);  
}  
 
private void UserControl_Load(
object sender， System.EventArgs e)  
{  
intLoginTime = 0;  
 
}  
}   
 
public class EventLoginArgs:System.EventArgs  
{  
public string strUserID;  
public string strUserName;  
public string strUserPWD;  
public bool bVaild;  
public EventLoginArgs(
string userID，string userName，string userPWD)  
{  
strUserID = userID;  
strUserName = userName;  
strUserPWD = userPWD;  
 
}  
}

它的客户程序主要如下:

 
 private void userControl1_SubmitLogin(
object sender， Userlogin.EventLoginArgs e)  
{  
　MessageBox.Show(
"This result is bLogin="+ userControl1.bLogin +
" At "+userControl1.intLoginTime +" times \n UserID="+e.strUserID+
"\n UserName="+e.strUserName，"TestResult"，MessageBoxButtons.OK);  
}  
private void Form1_Load(object sender， System.EventArgs e)  
{  
　userControl1.Server = "localhost";  
　userControl1.DataBase="weiwen";  
　userControl1.TableSet = "TestUser";  
　userControl1.UserForDB="sa";  
　userControl1.PWDForDB = "sa";  
}

以上就对C#编程中的组件-事件-委托做出了一些介绍。读者可以参考学习，也可直接使用此组件，但使用时应当以Microsoft SQL Server 作为后台数据库，所用到的用户表格应有 UserID，UserName，UserPWD三列，同时在客户程序中应对有关参数初始化，SubmitLogin事件返回值是尝试次数intLoginTime和验证是否成功bLogin，可参考扩展例子二。