Freigeben über

This- und Me-Einstellungen (IDE0003 und IDE0009)

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

Eigenschaft Wert
Regel-ID IDE0003
Titel Entfernenthis oder Me Qualifizieren
Kategorie Stil
Unterkategorie Sprachregeln (this.- und Me.-Qualifizierer)
Gültige Sprachen C# und Visual Basic
Optionen dotnet_style_qualification_for_field
dotnet_style_qualification_for_property
dotnet_style_qualification_for_method
dotnet_style_qualification_for_event
Eigenschaft Wert
Regel-ID IDE0009
Titel Hinzufügenthis oder Me Qualifizieren
Kategorie Stil
Unterkategorie Sprachregeln (this.- und Me.-Qualifizierer)
Gültige Sprachen C# und Visual Basic
Optionen dotnet_style_qualification_for_field
dotnet_style_qualification_for_property
dotnet_style_qualification_for_method
dotnet_style_qualification_for_event

Ü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, legen Sie den Schweregrad von IDE0003 auf Warnung oder Fehler fest. 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 werden bei dieser Konfiguration keine Methoden und Ereignisse gekennzeichnet, die die Qualifizierer und thisMe. Um zu erzwingen, dass auch Methoden und Ereignisse keine Qualifizierer aufweisen, aktivieren Sie IDE0003.

Hinweis

Auch wenn Sie Codeformatvorlagenregeln beim Build aktivieren, ist diese Regel nicht aktiviert. Sie wird nur in der IDE angezeigt.

Optionen

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

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

Eigenschaft Wert Beschreibung
Name der Option dotnet_style_qualification_for_field
Optionswerte true Feldern in C# bevorzugt this. oder in Visual Basic bevorzugt Me. voranstellen
false Feldern bevorzugt nichtthis. oder Me. voranstellen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option dotnet_style_qualification_for_property
Optionswerte true Eigenschaften in C# bevorzugt this. oder in Visual Basic bevorzugt Me. voranstellen
false Eigenschaften bevorzugt nichtthis. oder Me. voranstellen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option dotnet_style_qualification_for_method
Optionswerte true Methoden in C# bevorzugt this. oder in Visual Basic bevorzugt Me. voranstellen
false Methoden bevorzugt nichtthis. oder Me. voranstellen
Standardoptionswert 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

Eigenschaft Wert Beschreibung
Name der Option dotnet_style_qualification_for_event
Optionswerte true Ereignissen in C# bevorzugt this. oder in Visual Basic bevorzugt Me. voranstellen
false Ereignissen bevorzugt nichtthis. oder Me. voranstellen
Standardoptionswert 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

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 none auf fest.

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

Um alle Regeln im Code-Stil zu deaktivieren, setzen Sie den Schweregrad für die Kategorie Stylenone auf .

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

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

Siehe auch

  • Last updated on