从主窗体线程调用子窗体异步方法的问题求助

问题背景 #

主窗体控制含WebView2控件的子窗体，需批量执行截图操作：

• 直接在UI线程调用截图方法正常，但批量执行会导致界面冻结；
• 后台线程调用截图方法触发跨线程异常；
• 临时添加Sleep的方案稳定性极差，无法满足需求。

原简化代码逻辑：

private void PrimaryForm_Load(...)
{
    _secondaryForm = new SecondaryForm();
    _secondaryForm.Show();
}

private void Button_Click(...)
{
    Thread thread = new Thread(HeavyWork);
    thread.Start();
}

private void HeavyWork()
{
    // 循环几百次执行截图
    Task<string> task = CaptureScreenshotAsync();
    string str = task.Result;
    // 处理截图数据...
}

private async Task<string> CaptureScreenshotAsync()
{
    // 触发跨线程异常
    return await _secondaryForm.webView.CoreWebView2.CallDevToolsProtocolMethodAsync("Page.captureScreenshot", "{}");
}

正确解决思路 #

WebView2控件的所有操作必须在其所属的UI线程执行，后台线程仅负责非UI的耗时处理，通过UI线程调度完成截图操作，同时用异步逻辑避免界面冻结。

修正后代码示例 #

1. 改造截图方法，支持线程调度 #

private async Task<string> CaptureScreenshotAsync()
{
    // 判断当前线程是否为WebView2所在UI线程
    if (_secondaryForm.webView.InvokeRequired)
    {
        // 切换到UI线程执行截图逻辑
        return await (Task<string>)_secondaryForm.webView.Invoke(new Func<Task<string>>(CaptureScreenshotAsync));
    }
    else
    {
        // 确保CoreWebView2已初始化
        if (_secondaryForm.webView.CoreWebView2 == null)
            throw new InvalidOperationException("WebView2未完成初始化");
            
        return await _secondaryForm.webView.CoreWebView2.CallDevToolsProtocolMethodAsync("Page.captureScreenshot", "{}");
    }
}

2. 优化后台批量执行逻辑 #

private async void Button_Click(object sender, EventArgs e)
{
    // 用Task.Run启动后台任务，避免手动创建Thread
    await Task.Run(async () =>
    {
        // 模拟几百次循环执行
        for (int i = 0; i < 500; i++)
        {
            string screenshotBase64 = await CaptureScreenshotAsync();
            
            // 处理截图数据（如解析base64、保存文件等）
            // 注意：若需更新主窗体UI，需通过主窗体的Invoke方法切换线程
            // Example:
            // this.Invoke(new Action(() => { labelStatus.Text = $"已完成第{i+1}次截图"; }));
            
            // 可选：添加短暂延迟，避免过度占用资源
            await Task.Delay(10);
        }
    });
}

关键说明 #

• 线程调度：通过InvokeRequired和Invoke确保WebView2的API始终在其所属UI线程执行，避免跨线程异常。
• 异步非阻塞：用Task.Run结合async/await实现后台工作，避免.Result导致的线程阻塞和界面冻结。
• 初始化检查：必须确保WebView2的CoreWebView2已完成初始化，可在子窗体的CoreWebView2InitializationCompleted事件中标记初始化状态。

内容的提问来源于stack exchange，提问作者3AgL3 DeeJay