.NET 的 WebBrowser 类的异步/等待实现

Question

长期读者，第一次发帖。

我的目标：在使用 WebBrowser 类时能够利用 async/await 的优势。由于 WebBrowser.Navigate(string url) 是一个异步方法，因此在触发 LoadComplete 事件之前您无法检查 html 文档。

这是迄今为止我的（工作）代码：

public class AsyncWebBrowser
{
    protected WebBrowser m_WebBrowser;

    private ManualResetEvent m_MRE = new ManualResetEvent(false);

    public void SetBrowser(WebBrowser browser) {
        this.m_WebBrowser = browser;
        browser.LoadCompleted += new LoadCompletedEventHandler(WebBrowser_LoadCompleted);
    }

    public Task NavigateAsync(string url) {
        Navigate(url);

        return Task.Factory.StartNew((Action)(() => {
            m_MRE.WaitOne();
            m_MRE.Reset();
        }));
    }

    public void Navigate(string url) {
        m_WebBrowser.Navigate(new Uri(url));
    }

    void WebBrowser_LoadCompleted(object sender, NavigationEventArgs e) {
        m_MRE.Set();
    }
}

上一堂课现在允许我使用以下内容：

public async void NavigateToGoogle() {
    await browser.NavigateAsync("www.google.com");
    //Do any necessary actions on google.com
}

但是，我想知道是否有更有效/正确的方法来处理这个问题。具体来说，Task.Factory.CreateNew 具有阻塞ManualResetEvent。感谢您的意见！

Answer 1

首先，我认为这是学习 async/await 如何工作的一个很好的练习。

为了让 NavigateAsync 返回任务，您似乎正在经历重重困难。但它不必返回任务才能等待！ 包含await的方法必须返回Task，但是可等待的方法不需要返回Task；它所要做的就是返回某种类型，您可以在其上调用 GetAwaiter。

您可能会考虑实现这样的小类型：

public struct WebBrowserAwaiter<T>
{
    public bool IsCompleted { get { ... } }
    public void OnCompleted(Action continuation) { ... }
    public T GetResult() { ... }
}

并让 NavigateAsync 返回某种类型，您可以在该类型上调用返回 WebBrowserAwaiter 的 GetAwaiter。当您可以创建自己的任务时，无需仅仅为了获取其 GetAwaiter 方法而构建任务。

更一般地说，您可能需要考虑的是 如果在第一个仍在导航时第二次调用 NavigateAsync 会发生什么？

Answer 2

您可以使用

TaskCompletionSource<T>

创建任务并稍后将其标记为已完成。

我没有看到非通用任务的任何替代方案，但由于

Task<T>

源自

Task

，您可以只使用

TaskCompletionSource<object>

并将结果设置为 null。

Answer 3

我将 Vaibhav 的 VB 代码翻译为 C#。这是一个很棒的解决方案，我不知道为什么您对此感到失望。

public class YourClassThatIsUsingWebBrowser : IDisposable
{
    private WebBrowser browser;

    private TaskCompletionSource<BrowserResult> tcs;

    public YourClassThatIsUsingWebBrowser()
    {
        this.browser.DocumentCompleted += AsyncBrowser_DocumentCompleted;

        this.browser.Document.Window.Error += (errorSender, errorEvent) =>
        {
            SetResult(BrowserResult.Exception, errorEvent.Description);
        };
        this.browser.PreviewKeyDown += Browser_PreviewKeyDown;
        this.browser.Navigating += Browser_Navigating;
    }

    private void Browser_Navigating(object sender, WebBrowserNavigatingEventArgs e)
    {
        tcs = new TaskCompletionSource<BrowserResult>();
    }

    private void Browser_PreviewKeyDown(object sender, PreviewKeyDownEventArgs e)
    {
        if (e.KeyCode == Keys.Escape)
        {
            this.browser.Stop();
            SetResult(BrowserResult.Cancelled);
        }
    }

    private void AsyncBrowser_DocumentCompleted(object sender, WebBrowserDocumentCompletedEventArgs e)
    {
        SetResult();
    }


    public async Task<BrowserResult> NavigateAsync(string urlString)
    {
        this.browser.Navigate(urlString);

        return await tcs.Task;
    }

    private void SetResult(BrowserResult result = BrowserResult.Succeed, string error = null)
    {
        if (tcs == null)
        {
            return;
        }
        switch (result)
        {
            case BrowserResult.Cancelled:
                {
                    tcs.SetCanceled();
                    break;
                }
            case BrowserResult.Exception:
                {
                    tcs.SetException(new Exception(error));
                    break;
                }
            case BrowserResult.Succeed:
            default:
                {
                    tcs.SetResult(result);
                    break;
                }
        }

    }

    public void Dispose()
    {
        Dispose(true);
        GC.SuppressFinalize(this);
    }

    bool disposed = false;
    protected void Dispose(bool disposing)
    {
        if (!disposed)
        {
            if (disposing)
            {
                this.browser.Dispose();
            }
        }
        disposed = true;
    }
}
public enum BrowserResult
{
    Succeed,
    Cancelled,
    Exception,
}

Answer 4

我尝试了 Vaibhav J 的解决方案。

不幸的是，当尝试导航到某个地址时，它会出错。

bc30205 预期声明结束

Answer 5

我今天创建了这个类，在 stackoverflow 上的另一篇文章的帮助下，我想使用（异步/等待）获得准备好的网络浏览器控件，而无需任何线程阻塞。

Dim bb = New wbBrowser
Dim wb = Await bb.GetBrowserAsync("http://www.msn.com")

这是课程：

Imports System.Threading
Imports System.Threading.Tasks

Public Class wbBrowser
    Implements IDisposable

    Dim m_wbBrowser As New WebBrowser
    Dim m_tcs As TaskCompletionSource(Of WebBrowser)

    Public Sub New()
        m_wbBrowser.ScrollBarsEnabled = False
        m_wbBrowser.ScriptErrorsSuppressed = False
        AddHandler m_wbBrowser.DocumentCompleted, Sub(s, args) m_tcs.SetResult(m_wbBrowser)
    End Sub

    Public Async Function GetBrowserAsync(ByVal URL As String) As Task(Of WebBrowser)
        m_wbBrowser.Navigate(URL)
        Return Await WhenDocumentCompleted(m_wbBrowser)
    End Function

    Private Function WhenDocumentCompleted(browser As WebBrowser) As Task(Of WebBrowser)
        m_tcs = New TaskCompletionSource(Of WebBrowser)
        Return m_tcs.Task
    End Function

    Private disposedValue As Boolean
    Protected Overridable Sub Dispose(disposing As Boolean)
        If Not Me.disposedValue Then
            If disposing Then
                m_wbBrowser.Dispose()
            End If
        End If
        Me.disposedValue = True
    End Sub
    Public Sub Dispose() Implements IDisposable.Dispose
        Dispose(True)
        GC.SuppressFinalize(Me)
    End Sub

End Class