收集处理后台线程报错的方法

收集处理后台线程报错的方法

功能

后台线程异常报告给UI (用户界面) 线程的上层软件。

类和他们的关系

用户界面 UI类 伪代码

public class UIForm : Form //假设Win Form界面
{
    public UIActivityA() //调用后台任务的方法 (功能)
    {
        ...
    	Task taskX=new Task(); //实例化后台任务
    	...
    	taskX.AggregateExceptionOccured += 
            TaskX_AggregateExceptionOccured; //订阅异常响应方法
    }

    //异常响应方法范例
    //AggregateExceptionOccuredEventArgs 是自定义的出错诊断信息参数类
    private void TaskX_AggregateExceptionOccured(object sender, 	                                     AggregateExceptionOccuredEventArgs e)
    {
        MessageBox.Show(e.Exception.Message + Environment.NewLine +                                       e.Exception.StackTrace + e.Exception.InnerException?.Message); //显示警告
        this.Invoke(new Action(() => { GuiStop_Click(this, null); })); //调用关闭窗体方法
    }
    ...
}

后台任务 伪代码

public class Task
{
    //定义异步异常事件。
	public event AggregateExceptionOccuredEventHandler AggregateExceptionOccured;
    ...
    // 后台任务引擎。
    private void DoWorkEngine()
    {
	    try
    	{
            while(true)
            {
	        	...                
            }
    	}
    	catch(Exception exception)
    	{
        	//有异常，如果异步异常事件已被订阅，则调用订阅者的委托。
            var e = new AggregateExceptionOccuredEventArgs(DateTime.Now, 
                "Task 类 DoWorkEngine 异常", exception));
        	AggregateExceptionOccured?.BeginInvoke(sender, e, null, null);
    	}
        
    }
    
}

定义事件用到的类 伪代码

// 异步任务（如基于Thread/Task的引擎）执行出现异常时的委托。
public delegate void AggregateExceptionOccuredEventHandler(object sender, AggregateExceptionOccuredEventArgs e);

//定义出错诊断信息参数类
// 异步任务（如基于Thread/Task的引擎）执行出现异常的事件参数。
public class AggregateExceptionOccuredEventArgs : EventArgs
{

    #region------------------------- 公共属性 -------------------------

    /// <summary>
    /// 出现异常的时间。
    /// </summary>
    public DateTime Time { get; set; }

    /// <summary>
    /// 出现异常的任务名称。
    /// </summary>
    public string TaskName { get; set; }

    /// <summary>
    /// 异常信息。
    /// </summary>
    public Exception Exception { get; set; }

    #endregion

    #region------------------------- 构造函数 -------------------------

    /// <summary>
    /// 构造函数。
    /// </summary>
    /// <param name="time"></param>
    /// <param name="taskName"></param>
    /// <param name="exception"></param>
    public AggregateExceptionOccuredEventArgs(DateTime time, string taskName, Exception exception)
    {
        this.Time = time;
        this.TaskName = taskName;
        this.Exception = exception;
    }
    #endregion

}