Usar palavras-chave de idioma em vez de nomes de tipo de estrutura para referências de tipo (IDE0049)

Artigo
02/09/2025

Propriedade	Valor
ID da regra	IDE0049
Título	Use palavras-chave de idioma em vez de nomes de tipo de estrutura para referências de tipo
Categoria	Estilo
Subcategoria	Regras de idioma (palavras-chave de idioma em vez de nomes de tipo de estrutura)
Idiomas aplicáveis	C# e Visual Basic
Opções	`dotnet_style_predefined_type_for_locals_parameters_members`
	`dotnet_style_predefined_type_for_member_access`

Visão geral

Esta regra refere-se à utilização de palavras-chave linguísticas, quando existem, em vez de nomes de tipos do framework.

Observação

Mesmo que você habilitar regras de estilo de código node compilação, essa regra não estará habilitada. Ele só aparece no editor do Visual Studio.

Opções

Use as opções associadas a esta regra para aplicá-la a:

Variáveis locais, parâmetros de método e membros da classe - dotnet_style_predefined_type_for_locals_parameters_members
Expressões de acesso de membro-tipo - dotnet_style_predefined_type_for_member_access

Um valor de opção de true significa preferir a palavra-chave da linguagem (por exemplo, int ou Integer) em vez do nome do tipo (por exemplo, Int32) para tipos que têm uma palavra-chave para representá-los. Um valor de false significa que deve-se preferir o nome do tipo em vez da palavra-chave da linguagem.

Para obter informações sobre como configurar opções, consulte Formato de opção.

dotnet_style_predefined_type_for_locals_parameters_members

Propriedade	Valor	Descrição
Nome da opção	dotnet_style_predefined_type_for_locals_parameters_members
Valores de opção	`true`	Prefira a palavra-chave "language" para variáveis locais, parâmetros de método e membros da classe
	`false`	Prefira o nome do tipo para variáveis locais, parâmetros de método e membros de classe
Valor da opção padrão	`true`

// dotnet_style_predefined_type_for_locals_parameters_members = true
private int _member;

// dotnet_style_predefined_type_for_locals_parameters_members = false
private Int32 _member;

' dotnet_style_predefined_type_for_locals_parameters_members = true
Private _member As Integer

' dotnet_style_predefined_type_for_locals_parameters_members = false
Private _member As Int32

dotnet_style_predefined_type_for_member_access

Propriedade	Valor	Descrição
Nome da opção	dotnet_style_predefined_type_for_member_access
Valores de opção	`true`	Prefira a palavra-chave "language" para expressões de acesso a membros
	`false`	Prefira o nome do tipo para expressões de acesso de membro
Valor da opção padrão	`true`

// dotnet_style_predefined_type_for_member_access = true
var local = int.MaxValue;

// dotnet_style_predefined_type_for_member_access = false
var local = Int32.MaxValue;

' dotnet_style_predefined_type_for_member_access = true
Dim local = Integer.MaxValue

' dotnet_style_predefined_type_for_member_access = false
Dim local = Int32.MaxValue

Suprimir um aviso

Se você quiser suprimir apenas uma única violação, adicione diretivas de pré-processador ao arquivo de origem para desativar e, em seguida, reativar a regra.

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

Para desabilitar a regra para um arquivo, pasta ou projeto, defina sua gravidade como none no arquivo de configuração .

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

Para desabilitar todas as regras de estilo de código, defina a severidade da categoria Style como none no arquivo de configuração .

[*.{cs,vb}]
dotnet_analyzer_diagnostic.category-Style.severity = none

Para obter mais informações, consulte Como suprimir avisos de análise de código.

Ver também

Regras de linguagem de estilo de código
de referência de regras de estilo de código

Partilhar via