CA1824:組件必須標記 NeutralResourcesLanguageAttribute

  • 發行項
屬性 值
規則識別碼 CA1824
標題 組件必須標記 NeutralResourcesLanguageAttribute
類別 效能
修正程式是中斷或非中斷 不中斷
預設在 .NET 8 中啟用 建議

原因

元件包含 ResX 型資源，但未 System.Resources.NeutralResourcesLanguageAttribute 套用至該資源。

檔案描述

屬性 NeutralResourcesLanguageAttribute 會通知資源管理員應用程式的預設文化特性。 如果預設文化特性的資源內嵌在應用程式的主要元件中，而且 ResourceManager 必須擷取屬於與預設文化特性相同文化特性的資源，則 ResourceManager 會自動使用位於主要元件中的資源，而不是搜尋附屬元件。 這會略過一般元件探查、改善您載入之第一個資源的查閱效能，並減少您的工作集。

提示

如需用來探查資源檔的程式， ResourceManager 請參閱 封裝和部署資源 。

修正違規

若要修正此規則的違規，請將 屬性新增至元件，並指定中性文化特性資源的語言。

若要指定資源的中性語言

  1. 在 [方案總管] 中 ，以滑鼠右鍵按一下您的專案，然後選取 [ 屬性 ]。

  2. 選取 [套件] 索引標籤。

    注意

    如果您的專案是 .NET Framework 專案，請選取 [ 應用程式 ] 索引標籤，然後選取 [ 元件資訊 ]。

  3. 從 [中性語言 ] 或 [ 元件中性語言] 下拉式清單中選取語言 。

  4. 選取 [確定]。

隱藏警告的時機

允許隱藏此規則的警告。 不過，啟動效能可能會降低。 若要隱藏此警告，請將 新增 dotnet_diagnostic.CA1824.severity = none 至 .globalconfig 或 .editorconfig 檔案。

隱藏警告

如果您只想要隱藏單一違規，請將預處理器指示詞新增至原始程式檔以停用，然後重新啟用規則。

#pragma warning disable CA1824
// The code that's violating the rule is on this line.
#pragma warning restore CA1824

若要停用檔案、資料夾或專案的規則，請在組態檔 中將其嚴重性設定為 。 none

[*.{cs,vb}]
dotnet_diagnostic.CA1824.severity = none

如需詳細資訊，請參閱 如何隱藏程式碼分析警告 。

另請參閱