This- und Me-Einstellungen (IDE0003 und IDE0009)

Artikel
06/27/2023

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

Eigenschaft	Wert
Regel-ID	IDE0003
Titel	`this`- oder `Me`-Qualifizierung entfernen
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	`this`- oder `Me`-Qualifizierung hinzufügen
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 this und Meenthalten. Um zu erzwingen, 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 (dotnet_style_qualification_for_property)
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

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 nicht`this.` 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 nicht`this.` 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 nicht`this.` 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 nicht`this.` 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 Konfigurationsdatei auf none 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 in der KonfigurationsdateiStyle auf none.

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

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