Silverlight (XAP) Web 資源
發行︰ 2016年11月
適用於： Dynamics CRM 2015
重要
為回溯相容性，Microsoft Silverlight Web 資源在 Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 2015 更新 中保持支援。 對於可顯示在所有用戶端的元件，建議使用 HTML5 的 HTML Web 資源而非 Silverlight。
HTML5 是 Web 慣用的用戶端技術，優於 Web 外掛程式如 Silverlight 和 Flash。 HTML5 可以從任何裝置使用 (PC、平板電腦、智慧型手機等)，而且大量使用 JavaScript (和許多強大的 JavaScript 程式庫，例如 jQuery) 和 CSS。
Microsoft Dynamics CRM 2015 和 Microsoft Dynamics CRM Online 2015 更新 支援新增 Silverlight 4.0 Web 資源至實體表單。 您可以使用針對該版本設定的主控 <object> 元素，在 HTML Web 資源中顯示 Silverlight 5.0 Web 資源。
注意
-
Microsoft Silverlight Web 資源無法在 Microsoft Office Outlook 64 位元版本中檢視。
-
若要在實體表單或圖表外部顯示 Silverlight Web 資源，請建立 HTML Web 資源以做為 Silverlight Web 資源的主機頁面。 然後使用 $webresource: 指示詞來開啟 HTML Web 資源。
本主題內容
建立 Silverlight Web 資源
存取內容資料
從表單傳送資料至內嵌 Silverlight Web 資源
撰寫和測試 Silverlight Web 資源
偵錯 Silverlight Web 資源
建立 Silverlight Web 資源
使用 Web 資源表單，藉由輸入名稱，顯示名稱，選取 [Silverlight (XAP)] 為類型和上載 .xap 檔案，輕鬆建立 Silverlight Web 資源。 Web 資源必須先發行，才能使用。 不過，因為 Silverlight Web 資源通常提供與 Microsoft Dynamics 365 內容資料的一些互動，應規劃如何建立自己的 Web 資源。
存取內容資料
在 Web 資源表單中使用 [預覽] 按鈕或瀏覽至提供的 URL 時，Silverlight 應用程式是在一般 HTML 頁面上託管，不含內容資訊。 如果您的 Silverlight 應用程式不需要內容資訊，可以使用此 URL 檢視 Silverlight Web 資源。
如果需要內容資訊，您必須：
將 Silverlight Web 資源新增至實體表單。
使用設定提供內容資訊的 HTML Web 資源，檢視 Silverlight Web 資源。
如果您的 Silverlight Web 資源設計可在實體表單中檢視，表單有可用來存取內容資訊的 Xrm.Page.context 物件。 如需詳細資訊，請參閱用戶端內容 (用戶端參考)
如果您需要 Silverlight 應用程式在表單的內容外出現，必須透過新增 ClientGlobalContext.js.aspx 頁面的參照，設定 HTML Web 資源提供此內容資訊。 此參照新增後，您的 Silverlight 應用程式可用實體表單相同的方式存取內容資訊。 下列範例顯示如何從 Xrm.Page.context 物件呼叫 getClientUrl 函數。
private string clientUrl = "";
ScriptObject xrm = (ScriptObject)HtmlPage.Window.GetProperty("Xrm");
ScriptObject page = (ScriptObject)xrm.GetProperty("Page");
ScriptObject pageContext = (ScriptObject)page.GetProperty("context");
clientUrl = (string)pageContext.Invoke("getClientUrl");
從表單傳送資料至內嵌 Silverlight Web 資源
將 Silverlight Web 資源新增至表單時，可選取 [將記錄物件類型代碼及唯一識別碼傳遞為參數] 選項。 您也可以選擇輸入文字為自訂參數。
這些值傳遞至 Silverlight 控制項做為 InitParams，索引鍵/值組的字典。
下表描述傳遞的這些值。
索引鍵 |
描述 |
|---|---|
id |
記錄的唯一識別碼。 |
類型 |
實體類型代碼。 如果是自訂實體，這在組織之間可能不同。 |
typename |
實體的邏輯名稱。 |
orgname |
組織的名稱。 |
userlcid |
語言碼，代表使用者的語言喜好設定。 |
orglcid |
語言碼，代表組織的基礎語言。 |
資料 |
輸入的文字值，做為自訂參數。 |
使用下列範例的語法，這些值可在執行階段存取：
string entityTypeName = App.Current.Host.InitParams["typename"];
撰寫和測試 Silverlight Web 資源
如果您的 Silverlight Web 資源是獨立於 Microsoft Dynamics 365 的任何內容資料之外，您可照常撰寫和測試您的 Silverlight 應用程式。 當您上傳 .xap 檔案建立新的 Web 資源之後，您可以在儲存並發行 Web 資源之後，使用 Web 資源表單上的 [預覽] 按鈕測試它。
不過，您的 Silverlight 應用程式更可能會有內容資料相依性，而無法在 Microsoft Dynamics 365 外完整模擬。
建立包含表單或內容相依性的 Silverlight Web 資源程序如下：
建立自己的 Silverlight 應用程式專案。
您應選取使用您的專案建立 Web 應用程式。
盡可能撰寫和測試應用程式，而不需要 Microsoft Dynamics 365 的內容資料。
上傳 .xap 與 .htm 檔案做為 Silverlight 和 HTML Web 資源，建立 Web 資源。
在 Silverlight 應用程式專案中撰寫程式碼。
建置自己的 Silverlight 應用程式專案。
從 Web 應用程式專案 ClientBin 資料夾上傳 .xap 檔案的建置版本，更新您在步驟 3 建立的 Silverlight Web 資源。
根據測試您的 Silverlight Web 資源：
使用所建立主機 HTML Web 資源的 [預覽] 按鈕，檢視它。
在已新增至的實體表單的內容中檢視它。
如果您的 Silverlight 應用程式具有表單元素或內容資訊的相依性，使用此選項。
請重複步驟 4 到 7，直到完成。
注意
當您要在實體表單外顯示 Silverlight Web 資源時，例如在應用程式主框架中藉由編輯網站地圖，您必須提供網頁 (HTML) Web 資源，做為 Silverlight Web 資源的主控制項。
重要
不要使用應用程式提供的文字編輯器，編輯主控 Silverlight Web 資源的頁面的 HTML 原始程式碼。 文字編輯器會變更 HTML 並破壞主控 SilverlightXAP Web 資源的 <object> 必要元素定義。 如需詳細資訊，請參閱為 HTML Web 資源使用文字編輯器。
如果您必須使用文字編輯器，請在 <object> 元素中省略 data="data:application/x-silverlight-2," 參數。 雖然這應可避免破壞 Silverlight Web 資源，文字編輯器仍會引入其他不想要的變更。
偵錯 Silverlight Web 資源
不依賴 Microsoft Dynamics 365 內容資料的 Silverlight Web 資源可以在 Microsoft Visual Studio 中偵錯。 不過，如果 Silverlight Web 資源需要內容資料才能執行功能，您必須使用不同的程序。
建置自己的 Silverlight 應用程式。
從 Web 應用程式專案 ClientBin 資料夾上傳 .xap 檔案的建置版本。
在設計使用的內容中檢視 Silverlight 應用程式。
在 Silverlight 應用程式專案，從 Visual Studio 功能表，選取 [偵錯]，然後選取 [附加至處理序]。
在 [附加至處理序] 對話方塊中，找出 [類型] 欄值為 Silverlight, x86 的 iexplore.exe 處理序。
選取該處理序並按下 [附加]，關閉對話方塊以啟動偵錯。
在您的 Silverlight 應用程式專案，設定中斷點。
重新整理瀏覽器視窗，或在 Silverlight 應用程式，執行需要測試程式碼的動作。
另請參閱
建立可存取的 Web 資源
Microsoft Dynamics CRM 2015 的 Web 資源
網頁 (HTML) Web 資源
CSS Web 資源
指令碼 (JScript) Web 資源
資料 (XML) Web 資源
影像 (JPG、PNG、GIF、ICO) Web 資源
樣式表 (XSL) Web 資源
© 2017 Microsoft. 著作權所有，並保留一切權利。 著作權