从 2.0 迁移到 2.1

DotNetBrowser 2.1 版本对库的内部功能和公共 API 都做了一些改进。引擎版本已更新为 Chromium 79。本指南将介绍如何使使用 DotNetBrowser 2.0 版本编写的应用程序代码与 2.1 版本兼容。

为什么要迁移？

我们建议您将代码更新到最新版本，因为所有新功能、Chromium 升级、对新操作系统和 .NET Framework 版本的支持、错误修复、安全补丁、性能和内存使用的增强都会应用到最新版本之上。

需要多长时间？

根据我们的经验，升级到新版本可能需要几个小时到几天的时间，这取决于您在应用程序中使用的功能数量。跟以往一样，我们强烈建议在完成升级后，在软件支持的所有环境中测试软件。

获取帮助

如果您没有在本指南中找到答案，并且需要迁移方面的帮助，请联系我们。我们将竭诚为您提供帮助。

主要变更

下载处理程序

StartDownloadHandler 属性从 IDownloads 移至 IBrowser 接口。

v2.0

engine.Downloads.StartDownloadHandler = 
    new Handler<StartDownloadParameters, StartDownloadResponse>((p) =>
    {
        return StartDownloadResponse.DownloadTo(Path.Combine(Path.GetTempPath(),
            p.Download.Info.SuggestedFileName));
    });

engine.Downloads.StartDownloadHandler = 
    New Handler(Of StartDownloadParameters, StartDownloadResponse)(Function(p)
        Return StartDownloadResponse.DownloadTo(Path.Combine(Path.GetTempPath(),
            p.Download.Info.SuggestedFileName))
    End Function)

v2.1

browser.StartDownloadHandler = 
    new Handler<StartDownloadParameters, StartDownloadResponse>((p) =>
    {
        return StartDownloadResponse.DownloadTo(Path.Combine(Path.GetTempPath(),
            p.Download.Info.SuggestedFileName));
    });

browser.StartDownloadHandler = 
    New Handler(Of StartDownloadParameters, StartDownloadResponse)(Function(p)
        Return StartDownloadResponse.DownloadTo(Path.Combine(Path.GetTempPath(),
            p.Download.Info.SuggestedFileName))
    End Function)

删除的功能

新版本不再支持以下功能：

• INetwork.TransactionStarted 事件。您可以使用 INetwork.StartTransactionHandler 来代替。
• INetwork.BytesReceived 事件。您可以使用 INetwork.ResponseBytesReceived 事件来代替。
• INetwork.BytesSent 事件。
• INetwork.CanAccessFileHandler 使用的 CanAccessFileParameters 中不再提供 Url 属性。