preferencje i me (IDE0003 i IDE0009)

Artykuł
06/08/2023

W tym artykule opisano dwie powiązane reguły IDE0003 i IDE0009.

Właściwość	Wartość
Identyfikator zasady	IDE0003
Tytuł	Usunąć`this` lub `Me` kwalifikacje
Kategoria	Styl
Subcategory (Podkategoria)	Reguły języka ('this'' i 'Me'' kwalifikatory)
Odpowiednie języki	C# i Visual Basic
Opcje	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Właściwość	Wartość
Identyfikator zasady	IDE0009
Tytuł	Dodaj`this` lub `Me` kwalifikacje
Kategoria	Styl
Subcategory (Podkategoria)	Reguły języka ('this'' i 'Me'' kwalifikatory)
Odpowiednie języki	C# i Visual Basic
Opcje	`dotnet_style_qualification_for_field`
	`dotnet_style_qualification_for_property`
	`dotnet_style_qualification_for_method`
	`dotnet_style_qualification_for_event`

Omówienie

Te dwie reguły określają, czy wolisz używać tych kwalifikatorów (C#) i Me. (Visual Basic). Aby wymusić, że kwalifikatory nie są obecne, ustaw ważność IDE0003 ostrzeżenia lub błędu. Aby wymusić, że kwalifikatory są obecne, ustaw ważność IDE0009 ostrzeżenia lub błędu.

Jeśli na przykład wolisz kwalifikatory dla pól i właściwości, ale nie dla metod lub zdarzeń, możesz włączyć IDE0009 i ustawić opcje dotnet_style_qualification_for_field i dotnet_style_qualification_for_property na truewartość . Jednak ta konfiguracja nie będzie oznaczać metod i zdarzeń, które mająthis i Me kwalifikatory. Aby również wymusić, że metody i zdarzenia nie mają kwalifikatorów, włącz .IDE0003

Opcje

Skojarzone opcje tej reguły definiują, do których z następujących symboli należy zastosować następujące preferencje stylu:

Pola (dotnet_style_qualification_for_field)
Właściwości (dotnet_style_qualification_for_property)
Metody (dotnet_style_qualification_for_method)
Zdarzenia (dotnet_style_qualification_for_event)

Wartość true opcji oznacza, że symbol kodu ma być poprzedzony this. w języku C# i Me. w Visual Basic. Wartość false opcji oznacza, że element kodu nie ma być poprzedzony elementem this. lub Me..

Aby uzyskać więcej informacji na temat konfigurowania opcji, zobacz Format opcji.

dotnet_style_qualification_for_field

Właściwość	Wartość	Opis
Nazwa opcji	dotnet_style_qualification_for_field
Wartości opcji	`true`	Preferuj pola, które mają być poprzedzone językiem `this.` C# lub `Me.` Visual Basic
	`false`	Preferuj pola, które nie mają być poprzedzone lub `this.Me.`
Wartość opcji domyślnej	`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

Właściwość	Wartość	Opis
Nazwa opcji	dotnet_style_qualification_for_property
Wartości opcji	`true`	Preferuj właściwości, które mają być poprzedzone `this.` w języku C# lub `Me.` Visual Basic.
	`false`	Preferuj właściwości , które nie mają być poprzedzone właściwościami `this.` lub `Me.`.
Wartość opcji domyślnej	`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

Właściwość	Wartość	Opis
Nazwa opcji	dotnet_style_qualification_for_method
Wartości opcji	`true`	Preferuj metody, które mają być poprzedzone `this.` w języku C# lub `Me.` Visual Basic.
	`false`	Preferuj metody , które nie mają być poprzedzone metodami `this.` lub `Me.`.
Wartość opcji domyślnej	`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

Właściwość	Wartość	Opis
Nazwa opcji	dotnet_style_qualification_for_event
Wartości opcji	`true`	Preferuj zdarzenia, które mają być poprzedzone `this.` w języku C# lub `Me.` Visual Basic.
	`false`	Preferuj zdarzenia , które nie mają być poprzedzone ciągiem `this.` lub `Me.`.
Wartość opcji domyślnej	`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

Pomijanie ostrzeżenia

Jeśli chcesz pominąć tylko jedno naruszenie, dodaj dyrektywy preprocesora do pliku źródłowego, aby wyłączyć, a następnie ponownie włączyć regułę.

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

Aby wyłączyć regułę dla pliku, folderu lub projektu, ustaw jego ważność na none w pliku konfiguracji.

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

Aby wyłączyć wszystkie reguły stylu kodu, ustaw ważność kategorii Style na none w pliku konfiguracji.

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

Aby uzyskać więcej informacji, zobacz Jak pominąć ostrzeżenia analizy kodu.