detta och mig -inställningar (IDE0003 och IDE0009)

Artikel
05/07/2024

Den här artikeln beskriver två relaterade regler och IDE0003IDE0009.

Property	Värde
Regel-ID	IDE0003
Title	Ta bort`this` eller `Me` kvalificera
Kategori	Format
Underkategori	Språkregler ("det här"- och "Jag"-kval)
Tillämpliga språk	C# och Visual Basic
Alternativ	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Property	Värde
Regel-ID	IDE0009
Title	Lägg till`this` eller `Me` kvalificera
Kategori	Format
Underkategori	Språkregler ("det här"- och "Jag"-kval)
Tillämpliga språk	C# och Visual Basic
Alternativ	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Översikt

Dessa två regler definierar om du föredrar att använda dessa (C#) och Me. (Visual Basic)-kvalificerare. Om du vill framtvinga att kvalificerarna inte finns anger du allvarlighetsgraden IDE0003 för till varning eller fel. Om du vill framtvinga att kvalificerarna finns anger du allvarlighetsgraden IDE0009 för till varning eller fel.

Om du till exempel föredrar kvalificerare för fält och egenskaper, men inte för metoder eller händelser, kan du aktivera IDE0009 och ange alternativen dotnet_style_qualification_for_field och dotnet_style_qualification_for_property till true. Den här konfigurationen flaggar dock inte metoder och händelser som har this och Me kvalificerare. Aktivera för att även framtvinga att metoder och händelser inte har kvalificerare IDE0003.

Kommentar

Även om du aktiverar regler för kodformat vid kompilering är den här regeln inte aktiverad. Den visas bara i Visual Studio-redigeraren.

Alternativ

Den här regelns associerade alternativ definierar vilka av följande symboler som den här formatinställningen ska tillämpas på:

Fält (dotnet_style_qualification_for_field)
Egenskaper (dotnet_style_qualification_for_property)
Metoder (dotnet_style_qualification_for_method)
Händelser (dotnet_style_qualification_for_event)

Ett alternativvärde true för innebär att du föredrar att kodsymbolen föregås av this. I C# och Me. Visual Basic. Ett alternativvärde för innebär att kodelementet inte föregås this. av false eller Me..

Mer information om hur du konfigurerar alternativ finns i Alternativformat.

dotnet_style_qualification_for_field

Property	Värde	beskrivning
Alternativnamn	dotnet_style_qualification_for_field
Alternativvärden	`true`	Föredrar att fält föregås av `this.` i C# eller `Me.` i Visual Basic
	`false`	Föredrar att fält inte föregås av `this.` eller `Me.`
Standardalternativvärde	`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

Property	Värde	beskrivning
Alternativnamn	dotnet_style_qualification_for_property
Alternativvärden	`true`	Föredra att egenskaper föregås av `this.` I C# eller `Me.` Visual Basic.
	`false`	Föredrar att egenskaper inte föregås av `this.` eller `Me.`.
Standardalternativvärde	`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

Property	Värde	beskrivning
Alternativnamn	dotnet_style_qualification_for_method
Alternativvärden	`true`	Föredrar att `this.` använda metoder i C# eller `Me.` Visual Basic.
	`false`	Föredrar att metoder inte föregås av `this.` eller `Me.`.
Standardalternativvärde	`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

Property	Värde	beskrivning
Alternativnamn	dotnet_style_qualification_for_event
Alternativvärden	`true`	Föredrar att händelser föregås av `this.` i C# eller `Me.` i Visual Basic.
	`false`	Föredrar att händelser inte föregås av `this.` eller `Me.`.
Standardalternativvärde	`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

Ignorera en varning

Om du bara vill förhindra en enda överträdelse lägger du till förprocessordirektiv i källfilen för att inaktivera och återaktiverar sedan regeln.

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

Om du vill inaktivera regeln för en fil, mapp eller ett projekt anger du dess allvarlighetsgrad till none i konfigurationsfilen.

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

Om du vill inaktivera alla regler i kodformat anger du allvarlighetsgraden för kategorin Style till i konfigurationsfilen.none

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

Mer information finns i Så här utelämnar du kodanalysvarningar.

Share via