1. 首页
  2. >
  3. 编程技术
  4. >
  5. C#

将最新Chromium浏览器集成到.NET应用程序中

DotNetBrowser是一个.NET库,允许将基于Chromium的WPF和WinForms组件嵌入到.NET应用程序中,以显示使用HTML5,CSS3,JavaScript,Silverlight等构建的现代网页。

DotNetBrowser更新至v2.3版本,Chromium更新至84版本,允许从JavaScript访问和修改属性的值,增加拖放事件拦截和IDataObject支持,以及更多改进和修复,还没有使用过可以点击文末“了解更多”获取

将最新Chromium浏览器集成到.NET应用程序中

该产品的特征如下:

1、WPF或WinForms组件
DotNetBrowser提供.NET WPF和WinForms,它们能够被嵌入到.NET应用中来显示包含在现代网页中的HTML内容

2、准确显示Web

Web页面会通过Chromium引擎渲染出来,看起来就像在谷歌浏览器中一样
3、支持HTML5, CSS3, JavaScript

DotNetBrowser支持包含HTML5, CSS3, JavaScript的所欲现代网页标准。总体来讲,它所支持的Web标准就和谷歌浏览器一样
4、多进程架构

DotNetBrowser继承了Chromium的多进程架构。这就意味着每个页面都能在单独的Chromium渲染过程中呈现出来。实际上所有的本地功能都在单独的本地进程中运行。也就是说Chromium将不会使用你的.NET应用中的内存。
5、浏览器中的事件监听

你能监听到不同的网页浏览器事件,如开始载入框架、完成加载框架、框架加载失败、文档加载在主框架、标题和状态改变等事件。
6、JavaScript对话框处理

JavaScript对话框如警告、确认、提示、预加载,文件上传对话框可以使用DialogHandler处理。你可以选择是否显示JavaScript对话框。
7、加载处理程序

你可以使用LoadHandler处理任何的加载活动,包括在浏览器组件中过滤所有的URLS加载。
8、资源处理程序

你可以使用ResourceHandler处理资源加载,例如HTML,图像,JavaScript等
9、保存网页

The Browser.SaveWebPage()能让你保存加载的网页为一组文件
10、双向的JavaScript 与 .NET网桥

你可以在加载的网页中执行JavaScript代码并返回一个结果到.NET。你可以提交一个新的JavaScript函数并把他们与.NET方法联系起来。每次JavaScript调用这个函数,相应的.NET方法将会被应用。
11、弹出窗口处理程序

所有的弹出窗口都会被PopupHandler处理,你可以决定弹出窗口是否显示,以及如何去显示。
12、控制台监听

你可以使用ConsoleMessageEvent中不同级别的监听,比如调试,日志,警告或错误来监听控制台的消息,得到所加载的网页中的JavaScript错误通知。
13、证书对话框

DotNetBrowser应用程序接口允许处理SSL X.509客户端证书
14、插件管理器

使用插件管理器中的应用程序接口,你能得到关于可见插件,以及可用的或不可用的插件信息。
15、修改用户代理

你可以使用DotNetBrowser修改浏览器用户代理字符串,它将会被传送到Web服务器端。

DotNetBrowser迎来v2.3版本更新,为了方便大家尽可能顺利过度新版本,我们特意准备了本指南将帮助您了解新版本都要哪些新增与改动。

新增

Chromium 84

Chromium已更新至版本84.0.4147.135。

JS-.NET桥中的属性和字段访问方式

通过JS-.NET Bridge API访问注入JavaScript的.NET对象的公共属性和字段。JS-.NET Bridge API允许将.NET对象注入JavaScript并调用其公共方法。从此版本开始,它也可以与公共属性和字段一起使用。例如:

public class MyObject {     public string MyProperty {get; set;} } ... IJsObject window = frame.ExecuteJavaScript<IJsObject>("window").Result; window.Properties["myObject"] = new MyObject();

完成此操作后,您可以从JavaScript访问和修改属性的值:

window.myObject.MyProperty = "My value";

拖放事件拦截和IDataObject支持

在此版本中,IDragAndDrop.EnterDragHandler和IDragAndDrop.DropHandler被添加。这些处理程序可用于在硬件加速的呈现模式下拦截网页上相应的拖放事件。例如:

将最新Chromium浏览器集成到.NET应用程序中

private void OnDragEnter(EnterDragParameters arg) {     if (arg.Event.DropData != null)     {         //Write file names to debug output.         foreach (IFileValue file in arg.Event.DropData.Files)         {             Debug.WriteLine($"OnDragEnter: File = {file?.FileName}");         }     } }
private void OnDrop(DropParameters arg) {     if (arg.Event.DropData != null)     {         //Write file names to debug output.         foreach (IFileValue file in arg.Event.DropData.Files)         {             Debug.WriteLine($"OnDrop: File = {file?.FileName}");         }     } }

在.NET Framework中,还可以IDataObject在这些处理程序的范围内使用实例来接收和处理拖放数据的特定于平台的表示形式。--enable-com-in-drag-drop指定Chromium开关后,此功能可用。

改进

  • 如果没有为相应的IBrowser实例配置自定义的StartDownloadHandler,那么默认的StartDownloadHandler实现现在会在BrowserView初始化时配置。
  • 增加了默认的SelectCertificateHandler实现。如果没有为相应的IBrowser实例配置自定义的处理程序,那么这个实现将在BrowserView初始化时被配置。
  • 改进了SelectCertificateResponse.Select(Certificate)方法的功能。这个方法以前只用于自定义证书。现在,它将对来自处理程序参数的证书正常工作。
  • UrlRequest类扩展了以下属性。浏览器, 资源类型, SslVersion. 所有这些属性都可以用来获取关于这个URL请求的更多信息,包括发起这个请求的浏览器,请求资源的类型,以及用于执行请求的SSL版本。
  • 在 SaveAsPdfParameters 中添加了 SuggestedFileName 和 SuggestedDirectory。这些属性可用于在SaveAsPdfHandler中获得保存PDF文件的建议路径。
  • DOM键事件被扩展为字符属性。现在,它可以获得由按下键产生的字符,并与拦截的DOM键事件相关联。
  • 增加了INavigation.CurrentIndex属性。
  • 增加了Cookie.SameSite属性。
  • 引入了对Firebase Cloud Messaging的支持。
  • 禁用了将chromium.exe作为独立应用程序运行的功能。

问题修复

  • ShowNetErrorPageHandler对无效证书的网站不能正常工作。
  • 多次加载同一个页面时,页面加载时间增加。
  • 处置Browser后,部分内部对象未被释放造成的内存泄漏。
  • 网页未接收到DoubleClick DOM事件。
  • WPF BrowserView的Visibility属性绑定不能正常使用。
  • 对于Flash对象,上下文菜单只显示一次。
  • 对于在浏览器中打开的PDF文件不显示上下文菜单。
  • 在通过JS-.NET桥注册/取消注册.NET对象时出现了一些内存泄漏。
  • 初始化后,BrowserView不显示在第二个TabItem上。
  • CSS 3光标在Windows 7和Windows 2008 R2环境下不能正确显示。
  • 硬件加速模式下WPF BrowserView中的图片位置不正确。
  • 在BeforeUnloadHandler中显示和关闭默认对话框后,WinForms BrowserView没有恢复焦点。