从 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 属性。