XAML: 自定義控件中事件處理的最佳實(shí)踐方法
在開發(fā) XAML(WPF/UWP) 應(yīng)用程序中,有時(shí)候,我們需要?jiǎng)?chuàng)建自定義控件 (Custom Control) 來滿足實(shí)際需求。而在自定義控件中,我們一般會(huì)用到一些原生的控件(如 Button、TextBox 等)來輔助以完成自定義控件的功能。
自定義控件并不像用戶控件 (User Control) 一樣,使用 Code-Behind(UI 與邏輯在一起)技術(shù)。相反,它通過把 UI 與邏輯分離而將兩者解耦。因此,創(chuàng)建一個(gè)自定義控件會(huì)產(chǎn)生兩個(gè)文件,一個(gè)是 Generic.xaml,在它里面定義其模板與樣式;另一個(gè)是 <ControlName>.cs,這里面存放其邏輯,如下圖:

在這種情況下,要想在代碼中獲取到模板里定義的控件,就不像 Code-Behind 中那么容易,而要借助于 OnApplyTemplate 和 GetTemplateChild 這兩個(gè)方法。它們的意義分別如下:
OnApplyTemplate: 在自定義控件中,通常要重寫這個(gè)方法,當(dāng)基類調(diào)用 ApplyTemplate() 方法以構(gòu)造可視化樹時(shí),會(huì)調(diào)用它;
GetTemplateChild: 獲取 ControlTemplate 中所定義的可視化樹上指定名稱的元素;
所以,如果我們在模板中定義了一個(gè)名為 PART_ViewButton 的按鈕,那么,我們可以這樣獲取它,并為它注冊響應(yīng)事件:
public override void OnApplyTemplate()
{
base.OnApplyTemplate();
Button btnView = GetTemplateChild("PART_ViewButton") as Button;
if (btnView != null)
{
btnView.Click += BtnView_Click;
}
}
private void BtnView_Click(object sender, RoutedEventArgs e)
{
// 這里寫響應(yīng)邏輯
}
當(dāng)我們(或者其他人)要用這個(gè)控件時(shí),通過給它設(shè)置了模板(一般都是默認(rèn)模板)后, OnApplyTemplate 方法就會(huì)被執(zhí)行。這樣做看起來沒什么問題。不過,其實(shí)這里有可能會(huì)引起一個(gè)聽起來很嚴(yán)重的問題:內(nèi)存泄露 (Memory Leak)。
何為內(nèi)存泄露
內(nèi)存泄露有多種類型,一般來說,它是指某種類型的資源不再使用,但卻仍然占用內(nèi)存。換句話說,它從受管理的內(nèi)存區(qū)域中“泄漏”出去了。如果在程序中有多處內(nèi)存泄露,將會(huì)占有很多內(nèi)存,并最終導(dǎo)到內(nèi)存被耗盡。
在 C# 中,常見的內(nèi)存泄露有:
• 沒有移除事件監(jiān)聽;
• 沒有銷毀非托管資源(如數(shù)據(jù)庫、文件流等);
對于上面兩種情況,它們的解決辦法也非常簡單,分別是:要反注冊事件(即移除事件監(jiān)聽)與調(diào)用 Dispose 方法(如果沒有,則要實(shí)現(xiàn) IDisposable 接口,并在其中銷毀非托管資源)。
對于第二種情況,比較好理解;而對于第一種情況,問題是,為什么沒有移除事件監(jiān)聽,會(huì)導(dǎo)致內(nèi)存泄露呢?這是因?yàn)槭录幢仁录O(jiān)聽者的生命周期更長。來看代碼:
ObjectA objA = new ObjectA(); ObjectB objB = new ObjectB(); objA.Event += objB.EventHanlder;
ObjectA 中定義了 Event 事件,我們?yōu)樗粤艘粋€(gè)事件處理器(對象 objB 中的 EventHanlder 方法);因此,事件源 objA 對事件監(jiān)聽對象 objB 存在一個(gè)引用。
如果 objB 不再使用,我們要銷毀它,但由于 objA 引用了它,所以它不會(huì)被銷毀、回收;它要等到 objA 銷毀時(shí),才能被銷毀。所以本來需要被銷毀的對象,卻因有其它對象對它的引用,結(jié)果造成了內(nèi)存泄露。
如何解決
再回到自定義控件的問題上,因?yàn)槲覀兊淖远x控件,可能會(huì)被重寫樣式或者重寫模板,這會(huì)使 OnApplyTemplate 方法在這個(gè)自定義控件的生命周期內(nèi)被執(zhí)行多次。所以,我們需要為那些通過 GetTemplateChild 方法得到并且又添加了事件處理的控件(如上述代碼中的 btnView 控件)進(jìn)行事件反注冊。因?yàn)檫@些都是前一個(gè)模板中的控件(元素),當(dāng)反注冊后,原來的控件與事件監(jiān)聽者(自定義控件本身)就不存在引用關(guān)系,從而避免了內(nèi)存泄露的問題。
根據(jù)我們的解決思路,對之前的代碼重構(gòu)如下:
private Button btnView = null;
public override void OnApplyTemplate()
{
base.OnApplyTemplate();
// 先反注冊事件
if (btnView != null)
{
btnView.Click -= BtnView_Click;
}
btnView = GetTemplateChild("PART_ViewButton") as Button;
if (btnView != null)
{
btnView.Click += BtnView_Click;
}
}
private void BtnView_Click(object sender, RoutedEventArgs e)
{
// 這里寫響應(yīng)邏輯
}
這樣,就解決了本文開頭所說的問題。不過,接下來,我們還需要做一點(diǎn)調(diào)整。
進(jìn)一步重構(gòu)
試想,如果我們的自定義控件中,有多個(gè)類似像前述 btnView 這樣的控件,我們就要將上面的代碼在 OnApplyTemplate 方法中復(fù)制若干次,從而導(dǎo)致 OnApplyTemplate 方法的復(fù)雜度增加,以及代碼的可讀性變差 。
為了改善這一點(diǎn),我們將每個(gè)控件以及它的事件注冊與反注冊封裝一下。
重構(gòu)后,代碼如下:
protected const string PART_ViewButton = nameof(PART_ViewButton);
private Button btnView = null;
public Button ViewButton
{
get
{
return btnView;
}
set
{
// 先反注冊事件
if (btnView != null)
{
btnView.Click -= BtnView_Click;
}
btnView = value;
if (btnView != null)
{
btnView.Click += BtnView_Click;
}
}
}
public override void OnApplyTemplate()
{
base.OnApplyTemplate();
ViewButton = GetTemplateChild(PART_ViewButton) as Button;
}
private void BtnView_Click(object sender, RoutedEventArgs e)
{
// 這里寫響應(yīng)邏輯
}
針對最終的代碼,這里再提幾點(diǎn):
1. 在 OnApplyTemplate 方法中,建議一開始要先調(diào)用 base.OnApplyTemplate();
2. 無論在為控件反注冊事件,還是注冊事件時(shí),都要對控件是否為空進(jìn)行判斷,這是因?yàn)橛锌赡苡脩糁貙懩0鍟r(shí)沒有遵循 TemplatePart 屬性中所指定的控件名稱;
3. 將控件的名稱聲明為常量,可以避免字符串拼寫錯(cuò)誤;
總結(jié)
本文討論了在 WPF 或 UWP 中創(chuàng)建自定義控件時(shí),可能會(huì)遇到內(nèi)存泄露的問題;這主要是由于模板中的控件事件沒有反注冊導(dǎo)致的。我們不僅分析了其中的原因,也給出了針對這種情況的最佳實(shí)踐。
雖然在一般情況下,這一問題并不會(huì)造成較大的影響,但是,如果我們能夠在這些細(xì)節(jié)上注意,這樣不僅能夠提高我們的代碼質(zhì)量與程序的性能,也能夠給我們在設(shè)計(jì)或處理類似的問題時(shí),提供必要的思路與經(jīng)驗(yàn)。
以上這篇XAML: 自定義控件中事件處理的最佳實(shí)踐方法就是小編分享給大家的全部內(nèi)容了,希望能給大家一個(gè)參考,也希望大家多多支持腳本之家。
相關(guān)文章
Biwen.Settings如何添加對IConfiguration&IOptions的集成支持
Biwen.Settings?是一個(gè)簡易的配置項(xiàng)管理模塊,主要的作用就是可以校驗(yàn)并持久化配置項(xiàng),比如將自己的配置存儲(chǔ)到數(shù)據(jù)庫中,JSON文件中等,這篇文章主要介紹了Biwen.Settings如何添加對IConfiguration&IOptions的集成支持,需要的朋友可以參考下2024-05-05
Web.config 和 App.config 的區(qū)別分析
Web.config 和 App.config 的區(qū)別分析,需要的朋友可以參考一下2013-05-05
ASP.NET將文件寫到另一服務(wù)器(圖文教程)及注意事項(xiàng)
有時(shí)我們需要將來自于客戶端的文件上傳到WEB服務(wù)器端,并在服務(wù)端將文件存儲(chǔ)到第三方文件服務(wù)器中存儲(chǔ),既然有需求,那就有實(shí)現(xiàn)了,感興趣的你可以了解此文,或許對你學(xué)習(xí)asp.net 起到很好的作用哦2013-01-01
.NET 中英文混合驗(yàn)證碼實(shí)現(xiàn)代碼
.NET 中英文混合驗(yàn)證碼實(shí)現(xiàn)代碼2009-11-11
Server Application Unavailable出現(xiàn)的原因及解決方案小結(jié)
今天在服務(wù)器安裝了個(gè).net 4.0 framework(原本有1.0和2.0的),配置好站點(diǎn)后,選擇版本為4.0,訪問出錯(cuò),asp.net經(jīng)常會(huì)出現(xiàn)這個(gè)問題,這里腳本之家簡單的給整理下2012-05-05
.net中實(shí)現(xiàn)listBox左右移動(dòng)
這里給大家推薦的是一段網(wǎng)友分享的,使用.net實(shí)現(xiàn)listBox左右移動(dòng)的代碼,簡單實(shí)用,這里記錄下來,有需要的小伙伴參考下吧。2015-03-03
深入Lumisoft.NET組件POP3郵件接收與刪除操作的使用詳解
本篇文章對Lumisoft.NET組件POP3郵件接收與刪除操作的使用進(jìn)行了詳細(xì)的介紹。需要的朋友參考下2013-05-05

