CA1824:組件必須標記 NeutralResourcesLanguageAttribute
| 屬性 | 值 |
|---|---|
| 規則識別碼 | CA1824 |
| 職稱 | 組件必須標記 NeutralResourcesLanguageAttribute |
| 類別 | 效能 |
| 修正程式是中斷或非中斷 | 不中斷 |
| 預設在 .NET 9 中啟用 | 建議 |
原因
元件包含 ResX 型資源，但未 System.Resources.NeutralResourcesLanguageAttribute 套用至該資源。
檔案描述
屬性 NeutralResourcesLanguageAttribute 會通知資源管理員應用程式的預設文化特性。 如果預設文化特性的資源內嵌在應用程式的主要元件中，而且 ResourceManager 必須擷取屬於與預設文化特性相同文化特性的資源，則 ResourceManager 會自動使用位於主要元件中的資源，而不是搜尋附屬元件。 這會略過一般元件探查、改善您載入之第一個資源的查閱效能，並減少您的工作集。
提示
如需用來探查資源文件的程式，ResourceManager請參閱封裝和部署資源。
修正違規
若要修正此規則的違規，請將 屬性新增至元件，並指定中性文化特性資源的語言。
若要指定資源的中性語言
在 方案總管 中，以滑鼠右鍵按下您的專案，然後選取 [屬性]。
選取 [套件] 索引標籤。
注意
如果您的專案是 .NET Framework 專案，請選取 [ 應用程式 ] 索引卷標，然後選取 [ 元件資訊]。
從 [中性語言] 或 [元件中性語言] 下拉式清單中選取語言。
選取 [確定]。
隱藏警告的時機
允許隱藏此規則的警告。 不過，啟動效能可能會降低。 若要隱藏此警告，請將 新增 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
如需詳細資訊，請參閱 如何隱藏程式代碼分析警告。
