předvolby this and Me (IDE0003 a IDE0009)

Článek
05/07/2024

Tento článek popisuje dvě související pravidla IDE0003 a IDE0009.

Vlastnost	Hodnota
ID pravidla	IDE0003
Název	Odebrání `this` nebo `Me` kvalifikace
Kategorie	Styl
Podkategorie	Jazyková pravidla (kvalifikátory 'this.' a 'Me.')
Příslušné jazyky	C# a Visual Basic
Možnosti	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Vlastnost	Hodnota
ID pravidla	IDE0009
Název	Přidání `this` nebo `Me` kvalifikace
Kategorie	Styl
Podkategorie	Jazyková pravidla (kvalifikátory 'this.' a 'Me.')
Příslušné jazyky	C# a Visual Basic
Možnosti	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Přehled

Tato dvě pravidla definují, jestli dáváte přednost použití těchto kvalifikátorů (C#) a Me. (Visual Basic). Pokud chcete vynutit, aby kvalifikátory neexistují , nastavte závažnost IDE0003 upozornění nebo chyby. Chcete-li vynutit, aby byly kvalifikátory přítomny, nastavte závažnost IDE0009 upozornění nebo chyby.

Pokud například dáváte přednost kvalifikátorům pro pole a vlastnosti, ale ne pro metody nebo události, můžete povolit IDE0009 a nastavit možnosti dotnet_style_qualification_for_field a dotnet_style_qualification_for_property na truehodnotu . Tato konfigurace by však neoznačila metody a události, které mají this a Me kvalifikátory. Chcete-li také vynutit, aby metody a události nemají kvalifikátory, povolte IDE0003.

Poznámka:

I když v sestavení povolíte pravidla stylu kódu, toto pravidlo není povolené. Zobrazí se jenom v editoru sady Visual Studio.

Možnosti

Přidružené možnosti tohoto pravidla definují, na které z následujících symbolů by se tato předvolba stylu měla použít:

Pole (dotnet_style_qualification_for_field)
Vlastnosti (dotnet_style_qualification_for_property)
Metody (dotnet_style_qualification_for_method)
Události (dotnet_style_qualification_for_event)

Hodnota možnosti dává přednost symbolu true kódu, který má být předcházet this. v jazyce C# a Me. v jazyce Visual Basic. Hodnota false možnosti znamená preferovat prvek kódu, aby nebyl předcházet this. nebo Me..

Další informace o konfiguraci možností naleznete v tématu Formát možnosti.

dotnet_style_qualification_for_field

Vlastnost	Hodnota	Popis
Název možnosti	dotnet_style_qualification_for_field
Hodnoty možností	`true`	Preferujte pole, která mají být předcházet `this.` v jazyce C# nebo `Me.` v jazyce Visual Basic.
	`false`	Upřednostňujte pole, která nemají být předcházet `this.Me.`
Výchozí hodnota možnosti	`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

Vlastnost	Hodnota	Popis
Název možnosti	dotnet_style_qualification_for_property
Hodnoty možností	`true`	Preferujte vlastnosti, které mají být předcházet `this.` v jazyce C# nebo `Me.` v jazyce Visual Basic.
	`false`	Upřednostňujte vlastnosti , které nemají být předchycené `this.` nebo `Me.`.
Výchozí hodnota možnosti	`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

Vlastnost	Hodnota	Popis
Název možnosti	dotnet_style_qualification_for_method
Hodnoty možností	`true`	Preferujte metody, které mají být předcházet `this.` v jazyce C# nebo `Me.` v jazyce Visual Basic.
	`false`	Upřednostňujte metody , které nemají být předcházet `this.` nebo `Me.`.
Výchozí hodnota možnosti	`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

Vlastnost	Hodnota	Popis
Název možnosti	dotnet_style_qualification_for_event
Hodnoty možností	`true`	Upřednostňujte události `this.` v jazyce C# nebo `Me.` v jazyce Visual Basic.
	`false`	Upřednostňujte události , které nemají být předcházet `this.` nebo `Me.`.
Výchozí hodnota možnosti	`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

Potlačení upozornění

Pokud chcete potlačit pouze jedno porušení, přidejte do zdrojového souboru direktivy preprocesoru, abyste pravidlo zakázali a znovu povolili.

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

Pokud chcete pravidlo pro soubor, složku nebo projekt zakázat, nastavte jeho závažnost v none konfiguračním souboru.

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

Pokud chcete zakázat všechna pravidla stylu kódu, nastavte závažnost pro kategorii Style do none konfiguračního souboru.

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

Další informace naleznete v tématu Jak potlačit upozornění analýzy kódu.

Sdílet prostřednictvím