Udostępnij za pośrednictwem

preferencje i me (IDE0003 i IDE0009)

  • Artykuł

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

Właściwości Wartość
Identyfikator reguły IDE0003
Tytuł Usuwanie this lub Me kwalifikacje
Kategoria Styl
Podkategorii 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ści Wartość
Identyfikator reguły IDE0009
Tytuł Dodawanie this lub Me kwalifikacje
Kategoria Styl
Podkategorii 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ć obecność kwalifikatorów, 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 oznaczałaby flag 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

Uwaga

Nawet jeśli włączysz reguły stylu kodu w kompilacji, ta reguła nie jest włączona. Ma on tylko powierzchnie w edytorze programu Visual Studio.

Opcje

Skojarzone opcje tej reguły definiują, które z następujących symboli mają być stosowane do następujących preferencji stylu:

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

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

dotnet_style_qualification_for_field

Właściwości 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 this. lub 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ści Wartość Opis
Nazwa opcji dotnet_style_qualification_for_property
Wartości opcji true Preferuj właściwości, które mają być poprzedzone językiem this. 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ści Wartość Opis
Nazwa opcji dotnet_style_qualification_for_method
Wartości opcji true Preferuj metody, które mają być poprzedzone językiem this. C# lub Me. Visual Basic.
false Preferuj metody , które nie mają być poprzedzone ciągiem 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ści Wartość Opis
Nazwa opcji dotnet_style_qualification_for_event
Wartości opcji true Preferuj zdarzenia, które mają być poprzedzone językiem this. 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ść dla 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 dotyczące analizy kodu.

Zobacz też