一、引言：程序也會 “鬧脾氣”
家人們，咱就是說，有沒有這樣的經歷：滿心歡喜打開一個桌面應用程序，準備大干一場，結果操作沒幾下，突然彈出一個 “程序已停止工作” 的窗口 ，瞬間讓人心態崩了！這其實就是程序在運行過程中遇到了未處理的異常，直接 “撂挑子” 不干啦。
對于咱們開發 Winform 程序的小伙伴來說，這種情況更是不能容忍。一個小小的異常，可能就會讓用戶對我們的軟件失去信心。所以，今天就來和大家好好嘮嘮 Winform 程序中的全局異常捕獲處理，讓程序變得更 “堅強”，不再輕易 “鬧脾氣”！
二、認識異常：程序中的 “小怪獸”
（一）什么是異常
在程序的世界里，異常就像是突然冒出來的 “小怪獸” ，阻擋程序順利運行。簡單來說，異常就是程序在執行過程中出現的錯誤情況。當程序遇到一些不符合預期的條件，比如找不到文件、無法進行類型轉換，或者內存不足時，就會拋出異常。這些異常如果不加以處理，就會導致程序的運行中斷，就像汽車在行駛過程中突然爆胎，不得不停下來一樣。
（二）異常的類型和危害
在 Winform 開發中，常見的異常類型有很多。比如，空引用異常（NullReferenceException），這是最常見的異常之一。當你試圖訪問一個值為 null 的對象的屬性或方法時，就會拋出這個異常。想象一下，你手里拿著一個空盒子，卻想從里面拿出東西，肯定是拿不到的，程序就會拋出異常來提醒你。又比如類型轉換異常（InvalidCastException），當你嘗試將一個對象轉換為不兼容的類型時，就會出現這個問題。就好比你把蘋果當成橙子，強行要把蘋果榨成橙汁，這顯然是不行的 。
這些異常如果不處理，危害可不小。最直接的就是導致程序崩潰，用戶正在使用軟件，突然程序就關閉了，這體驗感簡直太差了。還可能導致數據丟失，比如用戶正在輸入重要信息，結果因為異常程序崩潰，之前輸入的數據沒保存下來，用戶肯定會很生氣。所以，為了讓程序穩定運行，給用戶提供良好的體驗，我們必須要處理這些異常。
三、全局異常捕獲：給程序穿上 “防護服”
（一）什么是全局異常捕獲
在 Winform 程序中，全局異常捕獲就像是給程序安裝了一個 “超級護盾” ，它可以捕獲整個應用程序中未處理的異常。簡單來說，就是不管程序的哪個部分出現了異常，只要沒有被局部的 try - catch 塊捕獲，全局異常捕獲機制就會發揮作用，把這些 “漏網之魚” 異常給抓住。
（二）為什么要使用全局異常捕獲
- 提高程序穩定性：當程序遇到異常時，如果沒有全局異常捕獲，很可能就會直接崩潰。而有了全局異常捕獲，就可以避免程序因為一些意外的異常而突然終止，讓程序更加穩定地運行。就好比給房子加固了地基，房子就不容易因為一點小震動而倒塌。
- 增強用戶體驗：想象一下，用戶在使用我們開發的 Winform 程序時，如果頻繁遇到程序崩潰的情況，肯定會對這個程序失去信心。通過全局異常捕獲，我們可以在程序出現異常時，給用戶一個友好的提示，比如 “很抱歉，程序出現了一點小問題，請稍后再試” ，而不是讓用戶看到一個莫名其妙的錯誤窗口，這樣可以大大提升用戶體驗。
- 方便錯誤排查：全局異常捕獲不僅可以捕獲異常，還可以記錄異常的詳細信息，比如異常發生的時間、異常類型、異常信息以及堆棧調用等。這些信息對于我們開發人員來說，就像是破案的線索，可以幫助我們快速定位和解決問題。當程序出現問題時，我們可以根據這些記錄的異常信息，迅速找到問題所在，提高開發效率。
四、實戰演練：打造異常捕獲 “神器”
（一）前期準備
在開始實戰之前，先確保我們的開發環境已準備就緒。這里我使用的是 Visual Studio 2022 ，它功能強大，能為我們的開發工作提供很多便利。.NET Framework 版本為 4.8，這個版本兼容性較好，能滿足大多數 Winform 項目的需求。如果你還沒有安裝這些工具，可以前往微軟官方網站進行下載安裝。
（二）關鍵代碼實現
- UI 線程異常捕獲
在 Winform 中，UI 線程負責處理用戶界面的交互和更新。為了捕獲 UI 線程中的異常，我們可以使用 Application.ThreadException 事件。下面是一段示例代碼：
// 設置應用程序處理異常方式：ThreadException處理
Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);
// 處理UI線程異常
Application.ThreadException += new System.Threading.ThreadExceptionEventHandler(Application_ThreadException);
在這段代碼中，Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException) 這行代碼設置了應用程序處理未處理異常的模式，這里設置為捕獲異常。Application.ThreadException += new System.Threading.ThreadExceptionEventHandler(Application_ThreadException) 則是為Application.ThreadException事件添加了一個處理程序，當 UI 線程中出現未處理的異常時，就會調用Application_ThreadException方法。
下面是Application_ThreadException方法的具體實現：
static void Application_ThreadException(object sender, System.Threading.ThreadExceptionEventArgs e)
{
string str = "";
string strDateInfo = "出現應用程序未處理的異常：" + DateTime.Now.ToString() + "\r\n";
Exception error = e.Exception as Exception;
if (error!= null)
{
str = string.Format(strDateInfo + "異常類型：{0}\r\n異常消息：{1}\r\n異常信息：{2}\r\n",
error.GetType().Name, error.Message, error.StackTrace);
}
else
{
str = string.Format("應用程序線程錯誤:{0}", e);
}
// 寫日志
WriteLog.WriteErrLog(str);
MessageBox.Show("發生致命錯誤，請及時聯系作者！", "系統錯誤", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
在這個方法中，首先獲取當前時間，構建異常信息的開頭部分。然后通過e.Exception獲取異常對象，進一步獲取異常類型、消息和堆棧跟蹤信息，并將這些信息格式化為一個字符串。接著調用WriteLog.WriteErrLog(str)方法將異常信息寫入日志文件，方便后續排查問題。最后使用MessageBox.Show方法彈出一個提示框，告知用戶程序出現了錯誤。
- 非 UI 線程異常捕獲
對于非 UI 線程中的異常，我們可以使用 AppDomain.CurrentDomain.UnhandledException 事件來捕獲。代碼如下：
// 處理非UI線程異常
AppDomain.CurrentDomain.UnhandledException += new UnhandledExceptionEventHandler(CurrentDomain_UnhandledException);
同樣，這里為AppDomain.CurrentDomain.UnhandledException事件添加了一個處理程序CurrentDomain_UnhandledException。下面是該方法的實現：
static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
string str = "";
Exception error = e.ExceptionObject as Exception;
string strDateInfo = "出現應用程序未處理的異常：" + DateTime.Now.ToString() + "\r\n";
if (error!= null)
{
str = string.Format(strDateInfo + "Application UnhandledException:{0};\\n\\r堆棧信息:{1}", error.Message, error.StackTrace);
}
else
{
str = string.Format("Application UnhandledError:{0}", e);
}
// 寫日志
WriteLog.WriteErrLog(str);
MessageBox.Show("發生致命錯誤，請停止當前操作并及時聯系作者！", "系統錯誤", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
這個方法和 UI 線程異常捕獲的方法類似，也是獲取異常信息，記錄日志并彈出提示框。不同的是，這里通過e.ExceptionObject獲取異常對象，因為非 UI 線程的異常處理方式和 UI 線程略有不同。
- 異常信息處理
在捕獲到異常后，對異常信息進行整理是很重要的一步。我們可以獲取異常的類型、消息、堆棧跟蹤等信息。例如，在前面的代碼中，通過error.GetType().Name獲取異常類型的名稱，error.Message獲取異常的具體消息，error.StackTrace獲取異常發生時的堆棧跟蹤信息。這些信息可以幫助我們快速定位問題所在，比如異常是在哪個類、哪個方法中發生的 。通過將這些信息記錄到日志文件中，我們可以在程序出現問題后，通過查看日志來分析問題，從而更好地解決問題。
（三）完整代碼示例
下面是一個完整的包含全局異常捕獲處理的 Winform 程序代碼示例：
using System;
using System.Windows.Forms;
using System.IO;
using System.Text;
namespace WinFormExceptionHandling
{
static class Program
{
/// <summary>
/// 應用程序的主入口點。
/// </summary>
[STAThread]
static void Main()
{
try
{
// 設置應用程序處理異常方式：ThreadException處理
Application.SetUnhandledExceptionMode(UnhandledExceptionMode.CatchException);
// 處理UI線程異常
Application.ThreadException += new System.Threading.ThreadExceptionEventHandler(Application_ThreadException);
// 處理非UI線程異常
AppDomain.CurrentDomain.UnhandledException += new UnhandledExceptionEventHandler(CurrentDomain_UnhandledException);
Application.EnableVisualStyles();
Application.SetCompatibleTextRenderingDefault(false);
Application.Run(new Form1());
}
catch (Exception ex)
{
string str = "";
string strDateInfo = "出現應用程序未處理的異常：" + DateTime.Now.ToString() + "\r\n";
if (ex!= null)
{
str = string.Format(strDateInfo + "異常類型：{0}\r\n異常消息：{1}\r\n異常信息：{2}\r\n",
ex.GetType().Name, ex.Message, ex.StackTrace);
}
else
{
str = string.Format("應用程序線程錯誤:{0}", ex);
}
// 寫日志
WriteLog.WriteErrLog(str);
MessageBox.Show("發生致命錯誤，請及時聯系作者！", "系統錯誤", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
static void Application_ThreadException(object sender, System.Threading.ThreadExceptionEventArgs e)
{
string str = "";
string strDateInfo = "出現應用程序未處理的異常：" + DateTime.Now.ToString() + "\r\n";
Exception error = e.Exception as Exception;
if (error!= null)
{
str = string.Format(strDateInfo + "異常類型：{0}\r\n異常消息：{1}\r\n異常信息：{2}\r\n",
error.GetType().Name, error.Message, error.StackTrace);
}
else
{
str = string.Format("應用程序線程錯誤:{0}", e);
}
// 寫日志
WriteLog.WriteErrLog(str);
MessageBox.Show("發生致命錯誤，請及時聯系作者！", "系統錯誤", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
static void CurrentDomain_UnhandledException(object sender, UnhandledExceptionEventArgs e)
{
string str = "";
Exception error = e.ExceptionObject as Exception;
string strDateInfo = "出現應用程序未處理的異常：" + DateTime.Now.ToString() + "\r\n";
if (error!= null)
{
str = string.Format(strDateInfo + "Application UnhandledException:{0};\\n\\r堆棧信息:{1}", error.Message, error.StackTrace);
}
else
{
str = string.Format("Application UnhandledError:{0}", e);
}
// 寫日志
WriteLog.WriteErrLog(str);
MessageBox.Show("發生致命錯誤，請停止當前操作并及時聯系作者！", "系統錯誤", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
public class WriteLog
{
public static void WriteErrLog(string str)
{
string path = Application.StartupPath + @"\ErrorLog.txt";
using (StreamWriter sw = new StreamWriter(path, true, Encoding.UTF8))
{
sw.WriteLine(DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss") + " " + str);
sw.Close();
}
}
}
}
在這個示例中，Program類是程序的入口點。在Main方法中，首先設置了異常處理模式，然后分別為 UI 線程和非 UI 線程的異常添加了處理程序。接著啟用可視化樣式，設置文本渲染默認值，并運行主窗體Form1。如果在Main方法中發生了異常，也會進行相應的處理，記錄日志并彈出提示框。WriteLog類負責將異常信息寫入日志文件，日志文件名為ErrorLog.txt，保存在應用程序的啟動目錄下。每寫入一條日志，都會包含當前時間和具體的異常信息 。通過這個完整的示例，希望大家能更好地理解和掌握 Winform 全局異常捕獲處理的實現。
五、優化與拓展：讓 “神器” 更強大
（一）異常日志記錄
在前面的代碼中，我們已經簡單實現了將異常信息寫入日志文件的功能。但在實際應用中，我們還可以對異常日志記錄進行進一步優化。比如，使用專業的日志記錄框架，像 Log4net，它功能更強大，配置更靈活。
使用 Log4net，首先要在項目中添加對它的引用。然后在配置文件（如 App.config）中進行配置，示例如下：
<configuration>
<configSections>
<section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
</configSections>
<log4net>
<appender name="FileAppender" type="log4net.Appender.FileAppender">
<file value="ErrorLog.log" />
<appendToFile value="true" />
<layout type="log4net.Layout.PatternLayout">
<conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
</layout>
</appender>
<root>
<level value="ALL" />
<appender-ref ref="FileAppender" />
</root>
</log4net>
</configuration>
在這段配置中，我們定義了一個名為FileAppender的日志輸出器，它將日志輸出到ErrorLog.log文件中。appendToFile屬性設置為true，表示每次記錄日志時，會追加到文件末尾，而不是覆蓋原有內容。layout部分定義了日志的格式，包括時間、線程、日志級別、記錄器名稱和消息內容。
在代碼中使用 Log4net 記錄異常日志也很簡單，示例如下：
using log4net;
using System.Reflection;
public class Program
{
private static readonly ILog log = LogManager.GetLogger(MethodBase.GetCurrentMethod().DeclaringType);
static void Main()
{
try
{
// 其他代碼
}
catch (Exception ex)
{
log.Error("發生未處理的異常", ex);
MessageBox.Show("發生致命錯誤，請及時聯系作者！", "系統錯誤", MessageBoxButtons.OK, MessageBoxIcon.Error);
}
}
}
在這個示例中，首先通過LogManager.GetLogger方法獲取一個日志記錄器，然后在捕獲到異常時，使用log.Error方法記錄異常信息，第一個參數是自定義的錯誤描述，第二個參數是異常對象。這樣，異常信息就會按照我們在配置文件中定義的格式記錄到日志文件中，方便我們后續查看和分析問題。
（二）自定義異常處理界面
默認的異常提示框（如MessageBox.Show彈出的框）雖然能簡單地告知用戶程序出現了錯誤，但不夠美觀和個性化。我們可以創建一個自定義的異常處理界面，讓程序在捕獲到異常時，以更友好、更專業的方式向用戶展示錯誤信息。
首先，創建一個新的 Winform 窗體，命名為ExceptionForm.cs。在這個窗體上，我們可以添加一些控件，如一個顯示錯誤信息的文本框，一個用于關閉窗體的按鈕，以及一些美化界面的圖片或標簽等。
示例代碼如下：
public partial class ExceptionForm : Form
{
public ExceptionForm(string errorMessage)
{
InitializeComponent();
txtErrorMessage.Text = errorMessage;
}
private void btnClose_Click(object sender, EventArgs e)
{
this.Close();
}
}
在這段代碼中，ExceptionForm類的構造函數接收一個errorMessage參數，用于顯示具體的異常信息。在構造函數中，將errorMessage賦值給文本框txtErrorMessage。當用戶點擊關閉按鈕btnClose時，調用this.Close()方法關閉窗體。
然后，在捕獲異常的地方，修改代碼，使用自定義的異常處理界面，而不是原來的MessageBox.Show。例如，在Application_ThreadException方法和CurrentDomain_UnhandledException方法中，將MessageBox.Show替換為：
ExceptionForm exceptionForm = new ExceptionForm(str);
exceptionForm.ShowDialog();
這樣，當程序捕獲到異常時，就會彈出我們自定義的異常處理界面，向用戶展示詳細的錯誤信息，讓用戶感受到我們對程序的用心，提升用戶對程序的好感度。
六、注意事項：避開異常捕獲的 “陷阱”
（一）避免過度捕獲
在設置全局異常捕獲時，一定要注意避免過度捕獲異常。雖然全局異常捕獲很強大，但如果捕獲得太寬泛，把所有異常都一股腦兒地抓進來，可能會隱藏真正的問題。比如說，在一個數據處理的方法中，可能會出現多種類型的異常，像數據格式錯誤、數據庫連接失敗等。如果我們在全局異常捕獲中沒有對這些異常進行區分，只是簡單地記錄一條 “發生異常” 的日志，那么當程序出現問題時，我們很難從這條簡單的日志中判斷出到底是哪里出了問題，這會給程序的調試帶來很大的困難 。所以，在捕獲異常時，要盡量做到精準捕獲，針對不同類型的異常進行不同的處理，這樣才能更好地定位和解決問題。
（二）合理處理異常
捕獲到異常后，如何處理異常也是很關鍵的。不能簡單地捕獲了異常，然后就什么都不做，或者只是簡單地顯示一個錯誤信息，這是遠遠不夠的。我們要根據具體的異常情況，進行合理的處理。比如，如果是因為網絡連接問題導致的異常，可以嘗試重新連接網絡；如果是文件讀寫錯誤，可以提示用戶檢查文件路徑是否正確，或者嘗試創建一個新的文件。在處理異常時，要保證程序的健壯性，不能因為一個異常的出現，就影響到整個程序的其他功能。要盡量讓程序在出現異常后，能夠繼續穩定地運行，或者至少給用戶提供一個友好的提示，讓用戶知道該如何操作，這樣才能提升程序的質量和用戶體驗 。
七、總結與展望：讓程序更穩定
通過今天的分享，家人們應該已經深刻認識到全局異常捕獲處理在 Winform 開發中的重要性啦！它就像是程序的 “保護神”，能夠大大提高程序的穩定性，讓我們的程序在面對各種異常情況時，都能保持良好的運行狀態，給用戶帶來更好的體驗。
從認識異常這個程序中的 “小怪獸”，到學會使用全局異常捕獲給程序穿上 “防護服”，再到一步步實現全局異常捕獲處理的代碼，以及對它進行優化和拓展，我們一起走過了一段充實的學習之旅。在這個過程中，我們掌握了 UI 線程和非 UI 線程異常捕獲的方法，學會了如何處理異常信息，還了解了如何優化異常日志記錄和創建自定義異常處理界面 。
閱讀原文：原文鏈接
該文章在 2025/2/5 18:35:44 編輯過
400 186 1886
