HTML 頁面會呼叫 Default.html.js 裡的 createSilverlight() 來把控制項放進頁面。典型寫法如下:
Sys.Silverlight.createObjectEx({
source: "Scene.xaml",
parentElement: document.getElementById("SilverlightControlHost"),
id: "SilverlightControl",
properties: {
width: "100%",
height: "100%",
version: "0.9"
},
events: {
onLoad: Sys.Silverlight.createDelegate(scene, scene.handleLoad)
}
});
這個呼叫用到的屬性大致可分成四組,分別對應不同的問題:
指定 Silverlight 控制項要呈現的 XAML 內容。它可以是外部檔案(如範例所示),也可以是同一頁面上某個具名 <script> 標記中所包含的 XAML。後者適合小片段或需要動態組出內容的場合。
在頁面上加入 Silverlight 控制項時,應該先準備一個具名的 <div> 作為容器,再把這個 <div> 的名稱指派給 parentElement。控制項會被渲染到該容器之內。
由 id 屬性指定。這個值之後會成為你在 JavaScript 中取得控制項參考的依據。
寬、高、版本等實體屬性是載入到 properties 陣列中設定的。這裡的 version 對應使用者端安裝的 Silverlight 執行階段版本;若指定版本高於使用者已安裝的版本,控制項不會載入,而會觸發 onError。完整的屬性清單可查閱 Silverlight SDK 文件。
onLoad 與 onError 是兩個最常用的事件。範例中的 Sys.Silverlight.createDelegate(scene, scene.handleLoad) 重點在於綁定「執行環境」——它讓 scene.handleLoad 被呼叫時,this 仍指向 scene 物件,而不是控制項本身。少了這層包裝,事件處理常會出現找不到物件的問題。
如果控制項遲遲不出現,依序檢查三件事:SilverlightControlHost 這個 div 是否真的存在於頁面上;Scene.xaml 的路徑是否正確(相對於頁面而非 JS 檔);以及頁面上是否已載入 Silverlight.js。另外,Silverlight 屬於已停止支援的技術,新專案不建議採用;維護既有系統時,值得留意現代瀏覽器已全面移除對它的支援。