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