CA1824: Marcar assemblies com NeutralResourcesLanguageAttribute
Property | valor |
---|---|
ID da regra | CA1824 |
Título | Marcar assemblies com NeutralResourcesLanguageAttribute |
Categoria | Desempenho |
A correção está quebrando ou não quebrando | Sem quebra |
Habilitado por padrão no .NET 8 | Como sugestão |
Motivo
Um assembly contém um recurso baseado em ResX, mas não tem o System.Resources.NeutralResourcesLanguageAttribute aplicado a ele.
Descrição da regra
O NeutralResourcesLanguageAttribute atributo informa o gerenciador de recursos sobre a cultura padrão de um aplicativo. Se os recursos da cultura padrão estiverem incorporados no assembly principal do aplicativo e ResourceManager tiverem que recuperar recursos que pertencem à mesma cultura da cultura padrão, o ResourceManager usará automaticamente os recursos localizados no assembly principal em vez de procurar um assembly satélite. Isso ignora a sonda de montagem usual, melhora o desempenho de pesquisa para o primeiro recurso que você carrega e pode reduzir seu conjunto de trabalho.
Gorjeta
Consulte Empacotar e implantar recursos para o processo que ResourceManager usa para investigar arquivos de recursos.
Corrigir violações
Para corrigir uma violação dessa regra, adicione o atributo ao assembly e especifique o idioma dos recursos da cultura neutra.
Para especificar a linguagem neutra para os recursos
No Gerenciador de Soluções, clique com o botão direito do mouse em seu projeto e selecione Propriedades.
Selecione a guia Pacote .
Nota
Se o seu projeto for um projeto do .NET Framework, selecione a guia Aplicativo e, em seguida, selecione Informações do assembly.
Selecione o idioma na lista suspensa Idioma neutro ou Idioma neutro do assembly.
Selecione OK.
Quando suprimir avisos
É permitido suprimir uma advertência desta regra. No entanto, o desempenho de inicialização pode se degradar. Para suprimir esse aviso, adicione ao seu arquivo .globalconfig ou .editorconfig.dotnet_diagnostic.CA1824.severity = none
Suprimir um aviso
Se você quiser apenas suprimir uma única violação, adicione diretivas de pré-processador ao seu arquivo de origem para desativar e, em seguida, reativar a regra.
#pragma warning disable CA1824
// The code that's violating the rule is on this line.
#pragma warning restore CA1824
Para desabilitar a regra para um arquivo, pasta ou projeto, defina sua severidade como none
no arquivo de configuração.
[*.{cs,vb}]
dotnet_diagnostic.CA1824.severity = none
Para obter mais informações, consulte Como suprimir avisos de análise de código.