Nadawanie nazw ostrzeżenia
Nazewnictwa ostrzeżenia wsparcia przestrzeganie konwencje nazewnictwa .NET Framework wytyczne do projektu.
W tej sekcji
Reguła |
Opis |
---|---|
Ta reguła zakłada, że nie jest obecnie używana członkowski wyliczenia, który ma nazwę, która zawiera "zastrzeżone", ale jest symbolem zastępczym nazwy lub usunięte w przyszłej wersji.Zmiana nazwy lub usuwanie członka jest zmiana podziału. |
|
Nazwa zdarzenia rozpoczyna się od "Przed" lub "Po".Nazwy związane z nimi zdarzenia, które są wywoływane w określonej kolejności, należy użyć obecnego lub przeszłość wskazujące położenie względne w sekwencji akcji. |
|
CA1714: Wyliczenia flag powinny mieć nazwy w liczbie mnogiej |
Publiczne wyliczenie ma atrybut System.FlagsAttribute i jego nazwa nie kończą się na "s".Typy, które są oznaczone FlagsAttribute mają nazwy, które są mnogiej, ponieważ atrybut wskazuje, że można określić więcej niż jedną wartość. |
Nazwa identyfikatora widoczne z zewnątrz zawiera jeden lub więcej wyrazów, które nie są rozpoznawane przez bibliotekę sprawdzania pisowni Microsoft. |
|
CA1708: Identyfikatory powinny się różnić o więcej niż w przypadku |
Identyfikatory obszarów nazw, typów, członków i parametry nie różnią się tylko w przypadku, ponieważ języki, w których docelowe common language runtime nie są wymagane będzie uwzględniana wielkość liter. |
Nazwa interfejsu, w którym widoczne z zewnątrz nie rozpoczyna się od kapitału "I".Nazwa parametru typu rodzajowego na zewnątrz typ lub metoda nie rozpoczyna się od kapitału "T". |
|
Nazwa parametru w członka widoczne z zewnątrz zawiera nazwę typu danych lub nazwa członka widoczne z zewnątrz zawiera nazwę typu danych specyficznych dla danego języka. |
|
CA1722: Identyfikatory nie powinien mieć niepoprawny prefiks |
Przez Konwencję tylko niektóre elementy programistyczne mają nazwy rozpoczynające się od określonego prefiksu. |
Umownie tylko nazwy typów, że rozszerzenie niektórych typów podstawowych lub że wdrożenie niektórych interfejsów lub typy pochodzące z tych typów powinien kończyć się szczególne sufiksy zarezerwowane.Inne nazwy typu nie należy używać tych zarezerwowanych sufiksów. |
|
CA1717: Tylko wyliczenia FlagsAttribute powinny mieć nazwy w liczbie mnogiej |
Konwencje nazewnictwa dyktować mnogiej nazwa wyliczenie wskazuje, że w tym samym czasie można określić więcej niż jedną wartość wyliczania. |
CA1725: Parametr nazwy powinny być zgodne zgłoszenia podstawowego |
Spójne nazw parametrów w hierarchii override zwiększa użyteczność przesłonięcia metody.Nazwa parametru w metodzie pochodnej, która różni się od nazwy w deklaracji z podstawowego mogą powodować zamieszanie, o tym, czy metoda jest przesłonięcie metody podstawowej lub nowych przeciążenia metody. |
Nazwa parametru powinny przekazywać znaczenie parametru, a nazwa członka powinny przekazywać znaczenie członka.Byłoby rzadkich projektu w przypadku, gdy były one takie same.Nazewnictwa parametr taki sam jak jego nazwa członka jest unintuitive i sprawia, że biblioteka jest trudne w użyciu. |
|
CA1701: Wyrazy złożone ciąg zasobów powinny być bocznym poprawnie |
Każdy wyraz w ciągu zasobu jest podzielony na tokeny, które są oparte na obudowy.Kombinacja dwóch token ciągłe jest sprawdzany przez biblioteki sprawdzania pisowni Microsoft.Jeżeli rozpoznany, wyraz powoduje naruszenie reguły. |
Ciąg zasobu zawiera jeden lub więcej wyrazów, które nie są rozpoznawane przez bibliotekę sprawdzania pisowni Microsoft. |
|
Wpisz nazwy powinny nie pasują do nazw obszarów nazw, które są zdefiniowane w .NET Framework Biblioteka klas.Naruszenie tej zasady można zmniejszyć użyteczność biblioteki. |
|
CA1707: Identyfikatory nie powinien zawierać znaki podkreślenia |
Umownie nazw identyfikatorów nie zawierają znak podkreślenia (_).Ta reguła sprawdza obszarów nazw, typów, członków i parametry. |
Nazwa członka publicznych lub chronionych zaczyna się od "Get", w przeciwnym razie odpowiada nazwie własności publicznej lub chronione. "Właściwości i metody Get"powinny mieć nazwy, które wyraźnie odróżniają ich funkcji. |
|
CA1716: Identyfikatory nie powinny być zgodne słowa kluczowe |
Nazwa obszaru nazw lub typ odpowiada zarezerwowanym słowem w języku programowania.Identyfikatory obszarów nazw i typów nie powinny być zgodne słowa kluczowe, które są definiowane przez języki, w których docelowe aparatu plików wykonywalnych języka wspólnego. |
Nazwa identyfikatora widoczne z zewnątrz zawiera termin, dla której istnieje alternatywny, preferowane termin.Alternatywnie nazwa zawiera określenie "Flaga" lub "Flagi". |
|
Umownie, nazwy parametrów używać camel obudowy i obszaru nazw, typów, a nazwy składników Pascal obudowy. |
|
Nazwa identyfikatora zawiera wiele wyrazów i co najmniej jeden z wyrazów wydaje się być mieszanek wyraz, który nie jest poprawnie bocznym. |
|
Nazwiska członków wyliczenia nie są poprzedzona nazwą typu, ponieważ oczekuje wpisz informacje dostarczane przez narzędzia programistyczne. |
|
Umownie, nazwy typów, że rozszerzenie niektórych typów podstawowych lub że wdrożenie niektórych interfejsów lub typy pochodzące z tych typów mają sufiks, który jest skojarzony z typem bazowym lub interfejsu. |