管理應用程式資源

資源檔案是屬於應用程式的一部分,但不會經過編譯的檔案,例如圖示檔案或音訊檔案。 由於這些檔案不屬於編譯處理程序的一部分,您可以變更它們而無需重新編譯二進位檔。 如果您打算將應用程式當地語系化,您應該針對所有字串和其他在將應用程式當地語系化時需要變更的資源使用資源檔。

警告

.resx 檔案中的資源可能會使用 BinaryFormatter 序列化,但不安全。 只在您信任的建置程序中包含這些 .resx 檔案。

如需 .NET 應用程式中資源的詳細資訊,請參閱 .NET 應用程式中的資源

使用資源

在 受控碼專案中,開啟 [專案屬性] 視窗。 您可以透過下列方式開啟 [屬性] 視窗:

  • 在 [方案總管] 中,以滑鼠右鍵按一下專案節點,並選取 [屬性]
  • Ctrl+Q 搜尋方塊中,輸入專案屬性
  • 在 [方案總管] 中按下 Alt+Enter

選取 資源 索引標籤。您可以在專案尚未包含 .resx 檔案的情況下新增該檔案、新增和刪除不同種類的資源,以及修改現有的資源。

Visual Studio 2022 及更新版本中的資源總管改善

從 Visual Studio 2022 版本 17.11 開始,資源總管經歷了重大改善。 請參閱 [重新設計的 Visual Studio 資源總管簡介]

要使用新的資源總管,您需要擁有一個包含一個或多個資源檔案的 .NET 專案 (.resx)。 若要打開資源總管,請在方案總管中以右鍵按一下任意資源檔案,然後選取 [以>資源總管打開]。 或者,您也可以使用鍵盤快速鍵 Ctrl+Alt+R

當您打開新的資源總管時,您可以在左側看到所有儲存的資源概觀,以及每個檔案的地區設定。 您可以設定在資料方格中顯示哪些地區設定。 這個介面可讓您並排比較翻譯,並在原地進行編輯。

顯示資源方格檢視的螢幕擷取畫面。

搜尋資源字串

在方格的左上方,您可以使用搜尋方塊來搜尋所有資源檔案中的文字。 若要搜尋資源,請在工具列上的搜尋方塊中輸入內容,然後按 Enter 鍵。 資料方格將僅顯示名稱、值或註解中符合您查詢的資源。 您可以使用萬用字元 (*) 來執行部分比對,並使用引號 (") 來執行精確比對。

為資源的特定翻譯新增註解

註解是很實用的方法,可提供資源更多資訊或上下文,例如字串的含義、用法或語氣。 在資源總管中,您可以為每個資源的翻譯新增註解,並在資料方格中一次查看所有註解。

若要為資源新增註解,請選擇對應於您想要加上註解之翻譯的儲存格,然後點擊工具列上的 [編輯註解] 按鈕,或按 Shift+Enter。 儲存格下方會顯示註解方塊,您可以在其中輸入註解。 按 Enter 以儲存註解,或按 Esc 以取消註解。

您可以透過點擊註解方塊或使用相同的鍵盤快速鍵,來編輯或刪除現有的註解。 若要查看資源的所有註解,請在每個具有註解的儲存格角落尋找小三角形圖示。 您可以將滑鼠懸停在圖示上,以查看顯示註解文字的工具提示,或點擊圖示以打開註解方塊。

註解可供資源檔案的多個使用者使用。 翻譯者、開發人員或資源管理員可以在翻譯旁邊留下附註、問題、說明或警告。 每個儲存格角落的小圖示表示該儲存格有註解。

顯示資源總管中註解 UI 的螢幕擷取畫面。

篩選資源

若要篩選資源,請點擊工具列上的篩選圖示,然後選擇您想套用的條件。 您可以按照名稱、值、註解、類型或檔案來篩選資源。

篩選 描述
名稱 僅顯示具有特定名稱或前置詞的資源。
僅顯示具有特定值或包含特定字串的資源。
註解 僅顯示具有註解或註解中包含特定字串的資源。
類型 僅顯示具有特定類型的資源,例如字串、影像或圖示。
檔案 僅顯示屬於特定檔案或文化特性的資源。

您可以組合多個篩選條件來縮小結果範圍,並點擊 [清除篩選器] 按鈕來清除篩選條件。

驗證和警告

預留位置是特殊的標記,在執行時會由動態值取代,例如 {0}{1}{name}。 如果在您的資源中使用預留位置,您需要確保它們在所有語言版本中保持一致,否則可能會在應用程式中出現錯誤或意外行為。

新的資源總管會自動驗證每個資源中的預留位置,並且如果發現預設文化特性與任何其他語言版本不符,則會顯示警告圖示。 例如,如果預設值為「Hello, {name}!」,而西班牙語的值為「Hola, {nombre}!」,則會顯示警告圖示,表示預留位置的名稱不同。 您可以將滑鼠懸停在圖示上,以查看工具提示中的不相符詳細資料,然後點擊圖示進行修正。

缺少翻譯是另一個常見問題,可能會影響應用程式的使用者體驗。 如果您未為某個文化特性中的資源提供翻譯,應用程式將恢復到預設文化特性,這對某些使用者來說可能並不適合或使其不甚滿意。 資源總管可以幫助您避免這個問題,當某個文化特性的資源沒有值時,會顯示警告圖示。 例如,如果>您有一個資源的預設值為 File,而法文地區沒有值,您會看到一個警告圖示,顯示該翻譯缺失。 您可以將滑鼠懸停在圖示上,查看顯示「沒有值」的提示,然後選擇它以新增值。

顯示缺少翻譯時資源總管的螢幕擷取畫面

自訂選項

Visual Studio 2022 及更新版本中的資資源總管支援螢螢幕助讀程式和輔助技術,以使視覺障礙或有其他身心障礙的開發者能更輕鬆地使用。 您可以使用鍵盤快速鍵在資料方格中導覽、編輯值和註解,以及執行常見的動作。 您還可以使用朗讀程式來讀出每個儲存格的內容,以及工具提示和警告。

若要調整縮放等級,請使用工具列上的縮放滑桿,或使用鍵盤快速鍵 Ctrl+=Ctrl+- 進行放大或縮小。使用 Ctrl+0 將縮放等級重設為預設值。

資源總管的主題與整個 Visual Studio 環境保持一致。 您可以選擇淺色、深色或藍色主題,資源總管會相應地進行調整。 您也可以透過 [工具]>[選項]>[環境]>[字型和顏色] 對話方塊,來變更資料方格的字型和顏色。

其他專案類型中的資源

.NET 專案管理資源的方式和其他專案類型不同。 如需下列資源的詳細資訊:

支援選項

如果您遇到管理應用程式資源的問題,請參閱在資源編輯器中針對錯誤進行疑難排解