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

Artigo
02/10/2025

Propriedade	Valor
ID da regra	IDE0049
Título	Usar palavras-chave de linguagem em vez de nomes de tipo de estrutura para referências de tipo
Categoria	Estilo
Subcategoria	Regras de idioma (palavras-chave de linguagem 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

Essa regra diz respeito ao uso de palavras-chave de linguagem, onde elas existem, em vez de nomes de tipo de estrutura.

Nota

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

Opções

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

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

Um valor de opção de true significa preferir a palavra-chave de idioma (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 preferir o nome do tipo em vez da palavra-chave do idioma.

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 das opções	`true`	Preferir a palavra-chave de linguagem para variáveis locais, parâmetros de método e membros de classe
	`false`	Preferir o nome do tipo para variáveis locais, parâmetros de método e membros de classe
valor de 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 das opções	`true`	Preferir a palavra-chave de linguagem para expressões de acesso de membro
	`false`	Preferir o nome de tipo para expressões de acesso de membro
valor de 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, insira diretivas de pré-processador no arquivo de origem para desabilitar e, em seguida, reabilitar 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 de um arquivo, pasta ou projeto, defina sua severidade 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 para 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.

Compartilhar via