在桌面客戶端中嵌入網頁,已經是很常見的做法——新聞彈出視窗、活動頁面、內嵌說明文件都屬這類。而這類架構的核心問題是:網頁裡的 JavaScript 如何呼叫宿主程式的功能?
.NET 的 WebBrowser 控制項使用的仍是 IE 內核。在 IE 中,window 物件有一個 external 屬性,它提供了一個外部介面,可以執行宿主程式碼。要透過它呼叫 C# 方法,有兩個必要條件:
在 Form 上放一個 WebBrowser 控制項,另外準備一個方法供 js 呼叫:
[System.Runtime.InteropServices.ComVisibleAttribute(true)]
public partial class Main : KSBiz.UI.KSForm
{
public Main()
{
InitializeComponent();
}
// 其餘省略
public void OpenForm(string s)
{
BasicInfo.CustomerList f = new StockManage.BasicInfo.CustomerList();
f.Show();
f.MdiParent = this;
webBrowser1.Visible = false;
}
}
ComVisibleAttribute(true) 讓整個類別對腳本可見。要注意這是一個安全性上的重大決定:一旦開放,載入的任何頁面都能呼叫這個類別上所有 public 方法。因此實務上應該只開放一個專用的、方法極少的代理類別,而非整個主視窗類別。
<body>
<h1>歡迎使用</h1>
<a href='#' onclick='window.external.OpenForm("test");'>客戶列表</a>
</body>
在網頁中,即可透過 window.external 呼叫 C# 的方法,如同呼叫本地物件一樣。
在 Form 的 Load 事件中,為 WebBrowser 設定頁面路徑,並指定腳本執行的宿主物件:
private void Main_Load(object sender, EventArgs e)
{
System.IO.FileInfo file = new System.IO.FileInfo("top.htm");
// WebBrowser 控制項顯示的網頁路徑
webBrowser1.Url = new Uri(file.FullName);
// 將當前類別設定為可由腳本存取
webBrowser1.ObjectForScripting = this;
}
設定完成,橋樑就搭好了。
實際專案中幾乎一定需要雙向溝通。C# 端可以呼叫:
webBrowser1.Document.InvokeScript("showMessage", new object[] { "從後端傳來的文字" });
或用 DocumentCompleted 事件確認頁面載入完成後再互動。這樣就構成完整的雙向通道:網頁負責呈現與互動,宿主負責系統功能。