Partilhar via


esta e Me preferências (IDE0003 e IDE0009)

Este artigo descreve duas regras IDE0003 relacionadas e IDE0009.

Property valor
ID da regra IDE0003
Título Remoção this ou Me qualificação
Categoria Estilo
Subcategoria Regras linguísticas (qualificadores «isto» e «eu»)
Línguas aplicáveis C# e Visual Basic
Opções dotnet_style_qualification_for_field
dotnet_style_qualification_for_property
dotnet_style_qualification_for_method
dotnet_style_qualification_for_event
Property valor
ID da regra IDE0009
Título Adicionar this ou Me qualificar
Categoria Estilo
Subcategoria Regras linguísticas (qualificadores «isto» e «eu»)
Línguas aplicáveis C# e Visual Basic
Opções dotnet_style_qualification_for_field
dotnet_style_qualification_for_property
dotnet_style_qualification_for_method
dotnet_style_qualification_for_event

Descrição geral

Essas duas regras definem se você prefere ou não o uso desses qualificadores (C#) e Me. (Visual Basic). Para impor que os qualificadores não estão presentes, defina a gravidade de IDE0003 como aviso ou erro. Para impor que os qualificadores estão presentes, defina a gravidade de IDE0009 como aviso ou erro.

Por exemplo, se você preferir qualificadores para campos e propriedades, mas não para métodos ou eventos, poderá habilitar IDE0009 e definir as opções dotnet_style_qualification_for_field e dotnet_style_qualification_for_property como true. No entanto, essa configuração não sinalizaria métodos e eventos que têm this e Me qualificadores. Para também impor que os métodos e eventos não tenham qualificadores, habilite IDE0003o .

Nota

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

Opções

As opções associadas a esta regra definem a qual dos seguintes símbolos esta preferência de estilo deve ser aplicada:

Um valor de opção de significa preferir que o símbolo de código seja precedido true this. em C# e Me. no Visual Basic. Um valor de opção de significa preferir que o elemento de código não seja precedido false ou this. Me..

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

dotnet_style_qualification_for_field

Property valor Description
Nome da opção dotnet_style_qualification_for_field
Valores de opção true Prefira campos a this. serem precedidos em C# ou Me. em Visual Basic
false Prefira campos que não sejam precedidos this. ou Me.
Valor da opção padrão false
// dotnet_style_qualification_for_field = true
this.capacity = 0;

// dotnet_style_qualification_for_field = false
capacity = 0;
' dotnet_style_qualification_for_field = true
Me.capacity = 0

' dotnet_style_qualification_for_field = false
capacity = 0

dotnet_style_qualification_for_property

Property valor Description
Nome da opção dotnet_style_qualification_for_property
Valores de opção true Prefira propriedades a serem precedidas this. em C# ou Me. no Visual Basic.
false Prefira propriedades que não sejam precedidas ou this. Me..
Valor da opção padrão false
// dotnet_style_qualification_for_property = true
this.ID = 0;

// dotnet_style_qualification_for_property = false
ID = 0;
' dotnet_style_qualification_for_property = true
Me.ID = 0

' dotnet_style_qualification_for_property = false
ID = 0

dotnet_style_qualification_for_method

Property valor Description
Nome da opção dotnet_style_qualification_for_method
Valores de opção true Prefira métodos a serem precedidos this. em C# ou Me. em Visual Basic.
false Prefira métodos que não sejam precedidos ou this. Me..
Valor da opção padrão false
// dotnet_style_qualification_for_method = true
this.Display();

// dotnet_style_qualification_for_method = false
Display();
' dotnet_style_qualification_for_method = true
Me.Display()

' dotnet_style_qualification_for_method = false
Display()

dotnet_style_qualification_for_event

Property valor Description
Nome da opção dotnet_style_qualification_for_event
Valores de opção true Prefira eventos a this. serem precedidos em C# ou Me. no Visual Basic.
false Prefira eventos que não sejam precedidos this. ou Me..
Valor da opção padrão false
// dotnet_style_qualification_for_event = true
this.Elapsed += Handler;

// dotnet_style_qualification_for_event = false
Elapsed += Handler;
' dotnet_style_qualification_for_event = true
AddHandler Me.Elapsed, AddressOf Handler

' dotnet_style_qualification_for_event = false
AddHandler Elapsed, AddressOf Handler

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 IDE0003 // Or IDE0009
// The code that's violating the rule is on this line.
#pragma warning restore IDE0003 // Or IDE0009

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

[*.{cs,vb}]
dotnet_diagnostic.IDE0003.severity = none
dotnet_diagnostic.IDE0009.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.

Consulte também