Udostępnij za pośrednictwem


Reguły nazewnictwa

Reguły nazewnictwa przyczyniają się do przestrzegania konwencji nazewnictwa zgodnie z wytycznymi projektowania platformy .NET.

W tej sekcji

Reguła Opis
CA1700: Nie nazywaj wartości wyliczenia "Reserved" Ta reguła zakłada, że element członkowski wyliczenia, który ma nazwę zawierającą "zarezerwowane", nie jest obecnie używany, ale jest symbolem zastępczym, który ma zostać zmieniony lub usunięty w przyszłej wersji. Zmiana nazwy lub usunięcie członka jest zmianą powodującą niezgodność.
CA1707: Identyfikatory nie powinny zawierać podkreślników Zgodnie z konwencją nazwy identyfikatorów nie zawierają znaku podkreślenia (_). Ta reguła sprawdza przestrzenie nazw, typy, elementy członkowskie i parametry.
CA1708: Identyfikatory powinny różnić się czymś więcej niż tylko wielkością liter Identyfikatory przestrzeni nazw, typów, elementów członkowskich i parametrów nie mogą się różnić jedynie wielkością liter, ponieważ języki docelowe dla wspólnego środowiska uruchomieniowego nie muszą uwzględniać wielkości liter.
CA1710: Identyfikatory powinny mieć poprawny sufiks Zgodnie z konwencją nazwy typów, które rozszerzają niektóre typy podstawowe lub implementują niektóre interfejsy lub typy pochodzące z tych typów, mają sufiks skojarzony z typem podstawowym lub interfejsem.
CA1711: Identyfikatory nie powinny mieć niepoprawnego sufiksu Zgodnie z konwencją nazwy typów, które rozszerzają określone typy podstawowe lub implementują określone interfejsy lub typy pochodzące z tych typów, powinny kończyć się określonymi sufiksami zarezerwowanymi. Inne nazwy typów nie powinny używać tych zastrzeżonych sufiksów.
CA1712: Nie prefiksu wartości wyliczenia z nazwą typu Nazwy elementów członkowskich wyliczenia nie są poprzedzone nazwą typu, ponieważ informacje o typie powinny być udostępniane przez narzędzia programistyczne.
CA1713: Zdarzenia nie powinny mieć prefiksu „przed” ani „po” Nazwa zdarzenia zaczyna się od "Przed" lub "Po". Aby nazwać powiązane zdarzenia wywoływane w określonej sekwencji, użyj czasu teraźniejszego lub przeszłego, aby wskazać względne miejsce w sekwencji działań.
CA1714: Wyliczenia flag powinny mieć nazwy mnogie Wyliczenie publiczne ma atrybut System.FlagsAttribute, a jego nazwa nie kończy się na "s". Typy oznaczone flagamiAttribute mają nazwy w liczbie mnogiej, ponieważ atrybut wskazuje, że można określić więcej niż jedną wartość.
CA1715: Identyfikatory powinny mieć poprawny prefiks Nazwa interfejsu widocznego zewnętrznie nie zaczyna się od litery "I". Nazwa ogólnego parametru typu w typie widocznym zewnętrznie lub metodzie nie zaczyna się od litery "T".
CA1716: Identyfikatory nie powinny być zgodne ze słowami kluczowymi Nazwa przestrzeni nazw lub nazwa typu pasuje do zastrzeżonego słowa kluczowego w języku programowania. Identyfikatory przestrzeni nazw i typów nie powinny być zgodne ze słowami kluczowymi zdefiniowanymi przez języki ukierunkowane na środowisko uruchomieniowe języka wspólnego.
CA1717: Tylko enumeracje FlagsAttribute powinny mieć nazwy w liczbie mnogiej Konwencje nazewnictwa określają, że nazwa w liczbie mnogiej dla wyliczenia wskazuje, że w tym samym czasie można określić więcej niż jedną wartości wyliczenia.
CA1720: Identyfikatory nie powinny zawierać nazw typów Nazwa parametru w zewnętrznie widocznym elemencie członkowskim zawiera nazwę typu danych lub nazwę widocznego zewnętrznie elementu członkowskiego zawiera nazwę typu danych specyficznego dla języka.
CA1721: Nazwy właściwości nie powinny być zgodne z metodami 'get' Nazwa publicznego lub chronionego elementu członkowskiego zaczyna się od "Get" i odpowiada nazwie właściwości publicznej lub chronionej. Metody i właściwości "Get" powinny mieć nazwy, które wyraźnie odróżniają ich funkcję.
CA1724: Nazwy typów nie powinny być zgodne z przestrzeniami nazw Nazwy typów nie powinny być zgodne z nazwami przestrzeni nazw platformy .NET. Naruszenie tej reguły może zmniejszyć użyteczność biblioteki.
CA1725: Nazwy parametrów powinny być zgodne z deklaracją bazową Spójne nazewnictwo parametrów w hierarchii przesłaniania zwiększa użyteczność przesłonień metod. Nazwa parametru w metodzie pochodnej, która różni się od nazwy w deklaracji podstawowej, może prowadzić do zamieszania dotyczącego tego, czy metoda jest przesłonięciem metody podstawowej, czy też nowym przeciążeniem metody.
CA1727: Użyj PascalCase dla nazwanych symboli zastępczych Użyj PascalCase dla nazwanych symboli zastępczych w szablonie komunikatu logowania.