WebBrowser中Javascript和Winform代码之间实现双向通信

╰半夏微凉° 2022-09-19 00:28 174阅读 0赞

# [WebBrowser一点心得，如果在Javascript和Winform代码之间实现双向通信][WebBrowser_Javascript_Winform] #

最近工作需要，学习了一下winform内嵌webbrowser控件，然后与htm页面中的javascript交互调用的技术，因此有了这篇心得。

总的来说，javascript与winform的code互相调用，和web开发中javascript与服务器端代码通过ajax互相调用有类似之处。

下面就用三个例子来说明：

**一.将WebBrowser控件放置在winform中，然后，写一个Page1.htm，内容如下：**

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">  
<html>  
<head>  
<title></title>  
<script type="text/javascript">  
function test(message)  
\{  
alert(message);  
\}  
</script>  
</head>  
<body>  
<button οnclick="test('test called from script code')">Button</button>  
</body>  
</html>

我将此Page1.htm显示在WebBrowser中看看，这个不难写，在winform中加上下面一句即可。  
webBrowser1.Url= new Uri("C:\\\\workspace\\\\WindowsFormsApp\\\\WindowsFormsApp\\\\Page1.htm");

然后运行，在winform中的webbrowser显示出来这个htm了，点按钮调用javascript函数，弹出alert提示，一切都很正常，没什么稀奇。

**二.如果我把javascript中的函数挪到winform的cs代码里，htm页面还能调用的到吗？**  
这有点ajax的味道了，在客户端的javascript里如何调用webpage.aspx.cs里的代码，在ajaxpro那时候，是需要在webpage.aspx.cs的代码里注册一下本页供ajax使用，在函数前也要声明一下是ajax函数的。

再说回来，如果想调用winform中的代码，也类似的，要给winform设置一下ComVisibleAttribute(true), 并给webbrowser控件设置一下webBrowser1.ObjectForScripting属性。  
webBrowser1.Url= new Uri("C:\\\\workspace\\\\WindowsFormsApp\\\\WindowsFormsApp\\\\Page1.htm");  
webBrowser1.ObjectForScripting = this;

其实，如果做的好，可以把这些代码专门归入一个类中，方便管理，这里就变为：webBrowser1.ObjectForScripting = new 某类()了;

然后，再在winform里写一个函数。  
public void Test(String message)  
\{  
MessageBox.Show(message, "client code");  
\}

最后，htm里调用时要用window.external前缀一下Test方法名。  
<button οnclick="window.external.Test('test called from windows code')">Button</button>

然后再运行，就发现，htm里的onclick事件，居然能调用winform里的code了，真是神奇！

完整winform代码如下：  
using System;  
using System.Windows.Forms;  
using System.Security.Permissions;  
  
namespace WindowsFormsApp  
\{  
\[PermissionSet(SecurityAction.Demand, Name = "FullTrust")\]  
\[System.Runtime.InteropServices.ComVisibleAttribute(true)\]  
public partial class Form2 : Form  
\{  
private WebBrowser webBrowser1 = new WebBrowser();

public Form2()  
\{  
InitializeComponent();

button1.Text = "call script code from client code";  
button1.Dock = DockStyle.Top;  
button1.Click += new EventHandler(button1\_Click);  
webBrowser1.Dock = DockStyle.Fill;  
Controls.Add(webBrowser1);  
Load += new EventHandler(Form2\_Load);

private void Form2\_Load(object sender, EventArgs e)  
\{  
webBrowser1.AllowWebBrowserDrop = false;  
webBrowser1.IsWebBrowserContextMenuEnabled = false;  
webBrowser1.WebBrowserShortcutsEnabled = false;  
webBrowser1.ObjectForScripting = this;  
webBrowser1.Url= new Uri("C:\\\\workspace\\\\WindowsFormsApp\\\\WindowsFormsApp\\\\Page1.htm");  
\}

public void Test(String message)  
\{  
MessageBox.Show(message, "client code");  
\}  
\}  
\}

总结一下，关键的webBrowser1.ObjectForScripting属性，ComVisibleAttribute(true)和window.external。

msdn说webBrowser1.ObjectForScripting属性的作用是：获取或设置一个对象，该对象可由显示在 WebBrowser 控件中的网页所包含的脚本代码访问。使用该属性可以启用 WebBrowser 控件承载的网页与包含 WebBrowser 控件的应用程序之间的通信。使用该属性可以将动态 HTML (DHTML) 代码与客户端应用程序代码集成在一起。为该属性指定的对象可作为 window.external 对象（用于主机访问的内置 DOM 对象）用于网页脚本。

可以将此属性设置为希望其公共属性和方法可用于脚本代码的任何 COM 可见的对象。可以通过使用 ComVisibleAttribute 对类进行标记使其成为 COM 可见的类。  
这一步也至关重要，如果不设置ComVisibleAttribute(true)，那这个程序就不能加载显示htm页面，因为htm里用了window.external.Test(）方法，该方法所在的类如果不ComVisible，就无法访问到了。反过来，如果设置了ComVisible，却不设置webBrowser1.ObjectForScripting属性，那代码执行时会报错：window.external无效或找不到对象。

而缺少了window.external，就更甭提了，因此，这三者缺一不可。

再看看这个window.external，在常见的javascript书中不见踪影，但却非常有用，一个常见的应用是：  
<input type="button" name="Button" value="add" οnclick="window.external.AddFavorite(location.href,document.title)" />

引用别人的"在嵌入了浏览器的工程中，除了IE默认提供的外部方法之外，需要网页的脚本中能调用c++代码，要实现这种交互，就必须实现脚本扩展。实现脚本扩展就是在程序中实现一个IDispatch接口，通过CHtmlView类的OnGetExternal虚函数返回此接口指针,这样就可以在脚本中通过window.external.XXX(关键字window可以省略)来引用接口暴露的方法或属性(XXX为方法或属性名)。"

再看看在c\#中的脚本扩展，只需要webBrowser1.ObjectForScripting和ComVisibleAttribute(true)简单一设置就完事了，简单吧！幸福吧！悲催吧！

**三.再来看一个，从winform的code里，能调用html页面里的javascript吗？**  
Page1.htm，删掉button，只保留javascript脚本。  
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">  
<html>  
<head>  
<title></title>  
<script type="text/javascript">  
function test(message)  
\{  
alert(message);  
\}  
</script>  
</head>  
<body>  
  
</body>  
</html>

using System;  
using System.Windows.Forms;  
using System.Security.Permissions;  
  
namespace WindowsFormsApp  
\{  
\[PermissionSet(SecurityAction.Demand, Name = "FullTrust")\]  
\[System.Runtime.InteropServices.ComVisibleAttribute(true)\]  
public partial class Form2 : Form  
\{  
private WebBrowser webBrowser1 = new WebBrowser();  
private Button button1 = new Button();

public Form2()  
\{  
InitializeComponent();

private void button1\_Click(object sender, EventArgs e)  
\{  
webBrowser1.Document.InvokeScript("test",  
new String\[\] \{ "called from client code" \});  
\}

\}  
\}

这回关键的因素就是webBrowser1.Document.InvokeScript了，而webBrowser1.ObjectForScripting，ComVisible不再需要了。

HtmlDocument.InvokeScript 方法的作用是：执行在 HTML 页面中定义的动态脚本函数。

至此，javascript与winform的code就可以互相调用了，感觉和web开发也有些类似。

这项技术叫在javascript(DHTML)代码和客户端应用程序代码之间实现双向通信.

[WebBrowser_Javascript_Winform]: http://www.cnblogs.com/liuzhendong/archive/2012/03/21/2409159.html