Qualifikationseinstellungen für den Mitgliedszugriff (IDE0003 und IDE0009)

In diesem Artikel werden zwei verwandte Regeln beschrieben, IDE0003 und IDE0009.

Übersicht

Diese beiden Regeln legen fest, ob Sie die Verwendung der Qualifizierer this (C#) und Me. (Visual Basic) bevorzugen sollten oder nicht. Um zu erzwingen, dass die Qualifizierer nicht vorhanden sind, setzen Sie den Schweregrad von IDE0003 auf Warnung oder Fehler. Um zu erzwingen, dass die Qualifizierer vorhanden sind, legen Sie den Schweregrad von IDE0009 auf Warnung oder Fehler fest.

Wenn Sie beispielsweise Qualifizierer für Felder und Eigenschaften bevorzugen, aber nicht für Methoden oder Ereignisse, dann können Sie IDE0009 aktivieren und die Optionen dotnet_style_qualification_for_field und dotnet_style_qualification_for_property auf true festlegen. Allerdings würde diese Konfiguration Methoden und Ereignisse, die tatsächlich die Qualifizierer und thisMe haben, nicht kennzeichnen. Um sicherzustellen, dass auch Methoden und Ereignisse keine Qualifizierer aufweisen, aktivieren Sie IDE0003.

Optionen

Die dieser Regel zugeordneten Optionen legen fest, auf welche der folgenden Symbole diese Stilpräferenz angewendet werden soll:

• Felder (dotnet_style_qualification_for_field)
• Eigenschaften (.NET-Stilqualifikation für Eigenschaften)
• Methoden (dotnet_style_qualification_for_method)
• Ereignisse (dotnet_style_qualification_for_event)

Der Optionswert true bedeutet, dass dem Codesymbol in C# bevorzugt this. oder in Visual Basic Me. vorangestellt werden soll. Der Optionswert false bedeutet, dass dem Codeelement bevorzugt nichtthis. oder Me. vorangestellt werden soll.

Weitere Informationen zum Konfigurieren von Optionen finden Sie unter Optionsformat.

dotnet_style_qualification_for_field

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

Unterdrücken einer Warnung

Um nur eine einzelne Verletzung zu unterdrücken, fügen Sie der Quelldatei Präprozessoranweisungen hinzu, um die Regel zu deaktivieren und dann wieder zu aktivieren.

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

Um die Regel für eine Datei, einen Ordner oder ein Projekt zu deaktivieren, legen Sie den Schweregrad in der Konfigurationsdatei none auf fest.

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

Um alle Code-Stil-Regeln zu deaktivieren, setzen Sie den Schweregrad für die Kategorie Style auf none in der Konfigurationsdatei.

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

Weitere Informationen finden Sie unter Vorgehensweise: Unterdrücken von Codeanalyse-Warnungen.

Siehe auch

• this (C#-Referenz)
• Sprachregeln für die Codeformatierung
• Referenz der Codeformatierungsregeln