Preferenze di qualificazione per l'accesso ai membri (IDE0003 e IDE0009)

Questo articolo descrive due regole correlate, IDE0003 e IDE0009.

Panoramica

Queste due regole definiscono se si preferisce o meno l'uso di questo qualificatore (C#) e Me. (Visual Basic). Per imporre che i qualificatori non siano presenti, impostare la gravità di IDE0003 su avviso o errore. Per imporre che i qualificatori siano presenti, impostare la gravità di IDE0009 su avviso o errore.

Ad esempio, se si preferisce qualificatori per campi e proprietà, ma non per metodi o eventi, è possibile abilitare IDE0009 e impostare le opzioni dotnet_style_qualification_for_field e dotnet_style_qualification_for_property su true. Tuttavia, questa configurazione non contrassegna metodi ed eventi che hannothisMe qualificatori. Per far sì che metodi ed eventi non abbiano qualificatori, abilitare IDE0003.

Opzioni

Le opzioni associate di questa regola definiscono a quali dei simboli seguenti deve essere applicata questa preferenza di stile:

• Campi (dotnet_style_qualification_for_field)
• Proprietà (dotnet_style_qualification_for_property)
• Metodi (dotnet_style_qualification_for_method)
• Eventi (dotnet_style_qualification_for_event)

Un valore di opzione di true significa preferire che il simbolo di codice sia preceduto da this. in C# e Me. in Visual Basic. Un valore di opzione di false significa che l'elemento di codice non deve essere preceduto da this. o Me..

Per altre informazioni sulla configurazione delle opzioni, vedere Formato delle opzioni.

dotnet_stile_qualificazione_per_campo

// 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

// 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

// 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

// 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

Eliminare un avviso

Se si desidera eliminare solo una singola violazione, aggiungere direttive del preprocessore al file di origine per disabilitare e quindi riabilitare la regola.

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

Per disabilitare la regola per un file, una cartella o un progetto, impostarne la gravità none su nel file di configurazione.

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

Per disabilitare tutte le regole in stile codice, impostare la gravità per la categoria Style su none nel file di configurazione.

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

Per altre informazioni, vedere Come eliminare gli avvisi di analisi del codice.

Vedi anche

• this (Riferimenti per C#)
• Regole del linguaggio di stile del codice
• Informazioni di riferimento sulle regole di stile del codice