předvolby this and Me (IDE0003 a IDE0009)

Článek
06/08/2023

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

Vlastnost	Hodnota
ID pravidla	IDE0003
Název	Odebrat`this` nebo `Me` kvalifikace
Kategorie	Styl
Subcategory	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řidat`this` nebo `Me` kvalifikace
Kategorie	Styl
Subcategory	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 (C#) a Me. (Visual Basic) kvalifikátorů. Pokud chcete vynutit, aby se kvalifikátory nenacházeny, nastavte závažnost IDE0003 na upozornění nebo chybu. Pokud chcete vynutit přítomnost kvalifikátorů, nastavte závažnost IDE0009 na upozornění nebo chybu.

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 true. Tato konfigurace však neoznačila metody a události, které mají this kvalifikátory a Me . Pokud chcete také vynutit, aby metody a události nemají kvalifikátory, povolte IDE0003.

Možnosti

Přidružené možnosti tohoto pravidla definují, na které z následujících symbolů se má tato předvolba stylu 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 true možností dává přednost symbolu kódu, který má být v jazyce C# a Me. v jazyce Visual Basic předcházet this. symbolu kódu. Hodnota parametru false dává přednost tomu, aby prvek kódu nebyl předcházet this.Me.nebo .

Další informace o konfiguraci možností najdete 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`	Upřednostňovat pole, která mají být v jazyce C# nebo `Me.` Visual Basic předcházet `this.`
	`false`	Upřednostňuji, aby pole nebyla předcházet nebo `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`	Upřednostňte `this.` vlastnosti v jazyce C# nebo `Me.` Visual Basic.
	`false`	Upřednostněte vlastnosti tak, aby nebyly předcházet nebo `this.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`	Preferujete metody, které mají být předcházet `this.` v jazyce C# nebo `Me.` Visual Basic.
	`false`	Upřednostňuji metody , které nemají být předcházet nebo `this.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`	V jazyce C# nebo `Me.` Visual Basic preferujete před událostmi`this.`.
	`false`	Upřednostňuji, aby události neměly před sebou `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, které pravidlo zakažou a znovu ho povolí.

#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 konfiguračním souboru na none .

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

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

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

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