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 IDE0003
o .
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:
- Campos (dotnet_style_qualification_for_field)
- Imóveis (dotnet_style_qualification_for_property)
- Métodos (dotnet_style_qualification_for_method)
- Eventos (dotnet_style_qualification_for_event)
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.