當地語系化自訂頁面上的標籤、訊息和工具提示

[本主題是發行前版本文件，並可能在未來變更。]

本文概述如何透過將每種語言的 Web 資源 RESX 檔案上傳到您的解決方案，來將當地語系化內容新增到自訂頁面。

本文將說明如何使用 Power Fx 在自訂頁面上設定控制項的內容。 您可以在自訂頁面上，針對工具提示和任何使用文字控制項的訊息使用類似步驟。

當地語系化自訂頁面上的標籤

組建支援全域使用者或多語言組織的應用程式時，在模型導向應用程式的自訂頁面上提供當地語系化內容十分重要。 可透過上傳 .resx 格式的文字檔作為 Web 資源來完成翻譯。 檔案包含要用於自訂頁面標籤的翻譯文字。

此程序的步驟如下：

1. 啟用您環境中的語言。
2. 將已當地語系化的 RESX Web 資源檔案新增至您的解決方案。
3. 將已當地語系化的檔案新增至自訂頁面。
4. 管理已當地語系化的 Web 資源。
5. 將已當地語系化的字串新增至控制項。
6. 使用已當地語系化的內容執行應用程式。

啟用您環境中的語言

若要新增自訂頁面的語言，您必須先在將執行自訂頁面的模型導向應用程式中，啟用想要支援的語言。 請確定您已從 Power Platform 系統管理中心啟用語言。 其他資訊：啟用語言

完成在環境中啟用語言的步驟後，請以正確格式為每種語言劍力一個 RESX 檔案，以便在模型導向應用程式的自訂頁面上當地語系化字元串。

使用當地語系化字串建立 RESX 檔案後，請將它們以 Web 資源的方式新增至解決方案中。 有兩種方法可以完成這項工作，第一種方式是在 make.powerapps.com 中打開您的解決方案，並選取在環境中將 Web 資源新增至解決方案的選項，或者您可以在使用自訂頁面時新增 Web 資源。 其他資訊：RESX Web 資源

本文稍後將在將當地語系化檔案新增到自訂頁面一節中介紹在使用自訂頁面時新增 Web 資源。

當地語系化的內容將根據自訂頁面執行之應用程式的使用者或組織地區設定而定。 應用程式的語言是根據使用者或管理員在 Power Platform 系統管理中心的使用者應用程式設定或管理設定中，所定義的語言喜好設定而定。 如果兩者皆未設定，則使用建立環境時的基礎語言設定。

注意

在 Power Apps Control Framework (PCF) 控制項中顯示的內容將當地語系化為應用程式區域設定語言，無需在自訂頁面上進行其他變更。 其他資訊：當地語系化 PCF 控制項

將已當地語系化的 RESX Web 資源檔案新增至您的解決方案

1. 移至 make.powerapps.com，選取解決方案區域，然後打開所需的解決方案。
2. 在命令列上選取新增 > 其他 > Web 資源。 這會打開一個面板，用以新增您的 RESX Web 資源檔案。

新增至您解決方案中的所有檔案都必須遵循包含 {filename}.LanguageID.resx 的特定格式，其中語言識別碼是該語言的數值。 這種格式是必要的，因為框架會根據命名慣例來找出應該使用哪個資源檔案將適當的當字語系化字串與 Label 控制項相關聯。

重要

所有檔案的 RESX {filename} 必須相同。

例如，所有當地語系化字串檔案的名稱都為 CustomPageLoc.LanguageID.resx，這代表英文為 CustomPageLoc.1033.resx、法文為 CustomPageLoc.1036.resx 和阿拉伯文 CustomPageLoc.1025.resx。 所新增的每個檔案的顯示名稱也必須是相同的名稱。

在以下範例中，所有檔案都是以 CPLoc 做為顯示名稱。 顯示名稱必須相同，才能確保所有當地語系化的內容在各種語言的自訂頁面上都能正確使用。 建議您在描述欄位中新增語言的對應名稱，以協助您在自訂頁面設計工具中查看檔案時識別內容。 此外，您必須新增您正在使用之語言的 RESX 檔案。 例如，如果您是以英文製作，請務必新增英文 RESX 檔案。

將 Web 資源新增至解決方案之後，請務必發佈變更。 發佈可確保該檔案可以新增至自訂頁面。 以下是已新增至解決方案且現在可以新增至自訂頁面的 Web 資源 RESX 檔案範例。

將已當地語系化的檔案新增至自訂頁面

當您建立或編輯頁面時，請將當地語系化的檔案新增至自訂頁面。

若要將語言新增至頁面，請選取左邊的資源圖示以打開資源窗格。

在兩個位置之一選取新增資源。

隨即會打開一個對話方塊，其中列出了您的解決方案中所有可用的 Web 資源。 若要快速尋找檔案，您可以使用對話方塊頂端的 [搜尋] 來搜尋顯示所有當地語系化 RESX 檔案的顯示名稱。 您只需選取，並新增與您用來製作頁面的語言相符的檔案。 在此範例中，您只需要新增英文檔案。

注意

不需要新增所有檔案，只需新增一個。 解決方案和平台會根據顯示名稱將上傳的語言對應至您已新增至解決方案的語言 Web 資源檔案。 當您新增多個檔案時，會顯示錯誤訊息對話方塊，指出已將檔案載入至您的頁面。

如果您在對話方塊中沒看見想要新增之語言的 RESX Web 資源，則需要使用本文稍早描述的步驟，將檔案新增至您的解決方案。

選取新增後，面板就會關閉，而 Web 資源會列在資源窗格中。

管理已當地語系化的 Web 資源

將 Web 資來源語言新增至頁面後，可以選取檔案旁邊的 ... 省略符號來管理檔案。 如果 Web 資源已更新，就會開啟一個彈出式視窗，您可以在其中重新整理 Web 資源。 您也可以從頁面移除資源。 如果顯示名稱已變更或已發佈到解決方案的 RESX 檔案中的任何字串索引鍵已更新，則您需要重新整理頁面上的 RESX 資源。 請注意，若要更新 RESX 檔案中的翻譯並發佈解決方案，則不需要重新整理頁面上的 RESX。

將已當地語系化的字串新增至 Label 控制項

若要將當地語系化的內容新增至 Label 控制項，請選取標籤，並使用控制項的 Power Fx Text 函數，將函數設定為資源。 若要執行此動作，請選取 Label 控制項，然後選取 Text 函數。

使用 Text 函數，將值設為 Web 資源，並在 Web 資源 RESX 檔案中設定所需的值。 設定運算式之後，內容將會顯示在頁面的預覽中。

儲存並發佈您對頁面所做的變更。

注意

請確定您也已儲存並發佈您對應用程式所做的變更。 若要確保您的當地語系化標籤會在執行時以適當的字串呈現，則需要儲存並發佈頁面和應用程式。

重要

當您新增 Form 控制項時，請確定您已將標籤當地語系化。 當您將控制項綁定至 Microsoft Dataverse 資料表時，它們不會自動提取當地語系化的標籤。 目前，您需要將標籤字串新增至 Resx 檔案、解除鎖定 Form 控制項，然後使用與自訂標籤、文字、工具提示等相同的運算式，將 displayName 屬性設定為您的當地語系化字串

使用已當地語系化的內容執行應用程式

1. 在發佈頁面及應用程式之後，在 應用程式設計工具中選取播放，以在個別的瀏覽器索引標籤中打開應用程式。

2. 在網站地圖上選取您的自訂頁面。

   

3. 控制項的標籤會顯示當地語系化的內容。 在應用程式頂端，選取設定 (齒輪圖示) 下方的個人化設定，以測試新增至您的應用程式和頁面的每種語言。

   

4. 然後，在語言索引標籤上，將使用者介面語言設為您要測試的語言。

   

自訂頁面支援從右至左

對於當地語系化的內容，有幾種語言要求在頁面上從右至左呈現內容。 阿拉伯語和希伯來語等語言完全支援從右至左 (RTL)，並且頁面會自動在執行時針對這些語言進行變更。

重要

自訂頁面目前不支援圖示、形狀和影像的從右至左方向。 如果您新增了圖示、形狀或影像，它可能不會如預期的方式運作，所以在自訂頁面上使用這些類型的控制項時，請務必小心。

若要在建立自訂頁面時查看 RTL，您必須移至頁面設定，選取即將推出的功能，搜尋 RTL，並啟用設定。 設定此選項時，會在預覽視窗中顯示 RTL 或 LTR 按鈕，您可以在其中切換方向，而無需執行應用程式。 若想要查看執行 RTL 的自訂頁面，您可以在執行應用程式時，在瀏覽器中的 URL 末尾新增 &flags=isRTL=true，以在頁面上測試 RTL。

使用 Resx 檔案匯出解決方案的已知限制

當您匯出解決方案並將其匯入新的環境中時，Resx 檔案並不會自動新增。  這是已知的限制，需要您將 Resx 檔案上傳至新環境中。  因此，如果您有開發人員環境，且您匯出解決方案並匯入到實際執行環境中，則需要將 Resx 當地語系化檔案新增至您的實際執行環境解決方案中。

請參閱

建立或編輯模型導向應用程式 Web 資源以擴充應用程式

模型導向應用程式的自訂頁面概觀