voorkeuren voor deze en mij (IDE0003 en IDE0009)

Artikel
05/07/2024

In dit artikel worden twee gerelateerde regels beschreven, IDE0003 en IDE0009.

Eigenschappen	Weergegeven als
Regel-id	IDE0003
Titel	Verwijderen `this` of `Me` kwalificeren
Categorie	Stijl
Subcategorie	Taalregels ('this.' en 'Me.'-kwalificaties)
Toepasselijke talen	C# en Visual Basic
Opties	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Eigenschappen	Weergegeven als
Regel-id	IDE0009
Titel	Toevoegen `this` of `Me` kwalificeren
Categorie	Stijl
Subcategorie	Taalregels ('this.' en 'Me.'-kwalificaties)
Toepasselijke talen	C# en Visual Basic
Opties	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Overzicht

Deze twee regels bepalen of u de voorkeur geeft aan het gebruik van deze (C#) en Me. (Visual Basic)-kwalificatie. Als u wilt afdwingen dat de kwalificaties niet aanwezig zijn, stelt u de ernst in op IDE0003 waarschuwing of fout. Als u wilt afdwingen dat de kwalificaties aanwezig zijn , stelt u de ernst in op IDE0009 waarschuwing of fout.

Als u bijvoorbeeld de voorkeur geeft aan kwalificaties voor velden en eigenschappen, maar niet voor methoden of gebeurtenissen, kunt u de opties dotnet_style_qualification_for_field inschakelen IDE0009 en instellen en dotnet_style_qualification_for_property op true. Deze configuratie markeert echter geen methoden en gebeurtenissen die wel this over en Me kwalificatie beschikken. Als u ook wilt afdwingen dat methoden en gebeurtenissen geen kwalificatie hebben, schakelt u het selectievakje in IDE0003.

Notitie

Zelfs als u regels voor codestijlen inschakelt op build, is deze regel niet ingeschakeld. Deze wordt alleen weergegeven in de Visual Studio-editor.

Opties

Met de bijbehorende opties van deze regel wordt gedefinieerd op welke van de volgende symbolen deze stijlvoorkeur moet worden toegepast:

Velden (dotnet_style_qualification_for_field)
Eigenschappen (dotnet_style_qualification_for_property)
Methoden (dotnet_style_qualification_for_method)
Gebeurtenissen (dotnet_style_qualification_for_event)

Een optiewaarde van true betekent geeft de voorkeur aan het codesymbool om vooraf te gaan in this. C# en Me. in Visual Basic. Een optiewaarde van false de middelen geeft de voorkeur aan het code-element dat niet wordt voorafgegaan door this. of Me..

Zie Optieindeling voor meer informatie over het configureren van opties.

dotnet_style_qualification_for_field

Eigenschappen	Weergegeven als	Beschrijving
Optienaam	dotnet_style_qualification_for_field
Optiewaarden	`true`	Geef de voorkeur aan velden om vooraf te gaan in `this.` C# of `Me.` in Visual Basic
	`false`	Geef de voorkeur aan velden die niet worden voorafgegaan door `this.` of `Me.`
Standaardoptiewaarde	`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

Eigenschappen	Weergegeven als	Beschrijving
Optienaam	dotnet_style_qualification_for_property
Optiewaarden	`true`	Geef de voorkeur aan eigenschappen om vooraf te gaan in `this.` C# of `Me.` in Visual Basic.
	`false`	Eigenschappen liever niet vooraf gaan aan `this.` of `Me.`.
Standaardoptiewaarde	`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

Eigenschappen	Weergegeven als	Beschrijving
Optienaam	dotnet_style_qualification_for_method
Optiewaarden	`true`	Geef de voorkeur aan methoden om vooraf te gaan in `this.` C# of `Me.` in Visual Basic.
	`false`	Geef de voorkeur aan methoden om niet vooraf te gaan aan `this.` of `Me.`.
Standaardoptiewaarde	`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

Eigenschappen	Weergegeven als	Beschrijving
Optienaam	dotnet_style_qualification_for_event
Optiewaarden	`true`	Geef de voorkeur aan gebeurtenissen om vooraf te gaan in `this.` C# of `Me.` in Visual Basic.
	`false`	Geef de voorkeur aan gebeurtenissen die niet worden voorafgegaan door `this.` of `Me.`.
Standaardoptiewaarde	`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

Een waarschuwing onderdrukken

Als u slechts één schending wilt onderdrukken, voegt u preprocessorrichtlijnen toe aan uw bronbestand om de regel uit te schakelen en vervolgens opnieuw in te schakelen.

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

Als u de regel voor een bestand, map of project wilt uitschakelen, stelt u de ernst none ervan in op het configuratiebestand.

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

Als u alle regels voor codestijl wilt uitschakelen, stelt u de ernst voor de categorie Style none in op in het configuratiebestand.

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

Zie Codeanalysewaarschuwingen onderdrukken voor meer informatie.

Share via