ez és Én beállítások (IDE0003 és IDE0009)

Cikk
05/07/2024

Ez a cikk két kapcsolódó szabályt IDE0003 és IDE0009.

Tulajdonság	Érték
Szabályazonosító	IDE0003
Cím	Eltávolítás`this` vagy `Me` minősítés
Kategória	Stílus
Alkategória	Nyelvi szabályok ('this.' és 'Me.' minősítők)
Alkalmazandó nyelvek	C# és Visual Basic
Beállítások	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Tulajdonság	Érték
Szabályazonosító	IDE0009
Cím	Hozzáadás`this` vagy `Me` minősítés
Kategória	Stílus
Alkategória	Nyelvi szabályok ('this.' és 'Me.' minősítők)
Alkalmazandó nyelvek	C# és Visual Basic
Beállítások	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Áttekintés

Ez a két szabály határozza meg, hogy a (C#) és Me. a (Visual Basic) minősítőket szeretné-e használni. Ha szeretné kikényszeríteni, hogy a minősítők ne jelenjenek meg, állítsa a súlyosságot IDE0003 figyelmeztetésre vagy hibára. A minősítők jelenlétének kényszerítéséhez állítsa a súlyosságot IDE0009 figyelmeztetésre vagy hibára.

Ha például a mezőkre és tulajdonságokra vonatkozó minősítőket részesíti előnyben, de a metódusokat és eseményeket nem, engedélyezheti IDE0009 és beállíthatja a beállításokatdotnet_style_qualification_for_field.dotnet_style_qualification_for_propertytrue Ez a konfiguráció azonban nem jelölné meg azokat a metódusokat és eseményeket, amelyek rendelkeznekthis és Me minősítők. Ha azt is szeretné, hogy a metódusok és események ne rendelkezzenek minősítőkkel, engedélyezze az engedélyezést IDE0003.

Feljegyzés

Még ha engedélyezi is a kódstílus-szabályokat a buildeléskor, ez a szabály nincs engedélyezve. Csak a Visual Studio szerkesztőjében jelenít meg.

Beállítások

A szabály társított beállításai határozzák meg, hogy az alábbi szimbólumok közül melyikre alkalmazza ezt a stílusbeállítást:

Mezők (dotnet_style_qualification_for_field)
Tulajdonságok (dotnet_style_qualification_for_property)
Metódusok (dotnet_style_qualification_for_method)
Események (dotnet_style_qualification_for_event)

Az eszközök beállítási true értéke előnyben részesíti a kódszimbólumot this. a C#-ban és Me. a Visual Basicben. Az eszközök beállítási false értéke előnyben részesíti a kódelemet , hogy ne legyen előtaggal this. vagy Me..

A beállítások konfigurálásáról további információt az Option formátum című témakörben talál.

dotnet_style_qualification_for_field

Tulajdonság	Érték	Leírás
Beállítás neve	dotnet_style_qualification_for_field
Beállításértékek	`true`	A C# vagy `Me.` a Visual Basic előtagú `this.` mezőinek előnyben részesítéséhez
	`false`	Előnyben részesítse a mezőket, hogy ne legyenek előtaggal `this.Me.`
Alapértelmezett beállításérték	`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

Tulajdonság	Érték	Leírás
Beállítás neve	dotnet_style_qualification_for_property
Beállításértékek	`true`	Előnyben részesíti a tulajdonságokat, ha a C# vagy `Me.` a Visual Basic előtaggal `this.` rendelkeznek.
	`false`	Előnyben részesítse a tulajdonságokat , hogy ne legyenek előtaggal `this.Me.`vagy .
Alapértelmezett beállításérték	`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

Tulajdonság	Érték	Leírás
Beállítás neve	dotnet_style_qualification_for_method
Beállításértékek	`true`	Előnyben részesíti a metódusokat, ha a C# vagy `Me.` a Visual Basic előtaggal kell rendelkeznie`this.`.
	`false`	Előnyben részesítse a metódusokat , hogy ne legyenek előtaggal `this.Me.`vagy .
Alapértelmezett beállításérték	`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

Tulajdonság	Érték	Leírás
Beállítás neve	dotnet_style_qualification_for_event
Beállításértékek	`true`	Az eseményeket a C# vagy `Me.` a Visual Basic előtaggal `this.` szeretné megjeleníteni.
	`false`	Előnyben részesítse az eseményeket , hogy ne legyenek előtaggal `this.Me.`vagy .
Alapértelmezett beállításérték	`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

Figyelmeztetés mellőzése

Ha csak egyetlen szabálysértést szeretne letiltani, adjon hozzá előfeldolgozási irányelveket a forrásfájlhoz a szabály letiltásához és újbóli engedélyezéséhez.

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

Ha le szeretné tiltani egy fájl, mappa vagy projekt szabályát, állítsa annak súlyosságát none a konfigurációs fájlban.

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

Az összes kódstílus-szabály letiltásához állítsa be a kategória Style súlyosságát none a konfigurációs fájlban.

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

További információ: Kódelemzési figyelmeztetések letiltása.

Megosztás a következőn keresztül: