深入理解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中輸出最後一行。

　　注意若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";
}

　　這兩個例子的完整代碼可以點擊這裡下載.

　　讀者可以參考學習，也可直接使用此組件，但使用時應當以Microsoft SQL Server 作為後台資料庫，所用到的使用者表格應有 UserID，UserName，UserPWD三列，同時在客戶程式中應對有關參數初始化，SubmitLogin事件傳回值是嘗試次數intLoginTime和驗證是否成功bLogin，可參考擴充例子二。