Udostępnij za pośrednictwem


CA1702: Wyrazy złożone należy zapisywać z uwzględnieniem wielkości liter

Pozycja Wartość
Ruleid CA1702
Kategoria Microsoft.Naming
Zmiana powodująca niezgodność Rozbijanie — w przypadku wystrzeliwania na zestawy.

Bez przerywania — po wyzwoleniu parametrów typu.

Przyczyna

Nazwa identyfikatora zawiera wiele wyrazów i co najmniej jeden z nich wydaje się wyrazem złożonym, w którym wielkość liter nie jest poprawna.

Uwaga

Ta reguła została przestarzała. Aby uzyskać więcej informacji, zobacz Przestarzałe reguły.

Opis reguły

Nazwa identyfikatora jest podzielona na wyrazy oparte na wielkości liter. Każda ciągła kombinacja dwóch wyrazów jest sprawdzana przez bibliotekę sprawdzania pisowni firmy Microsoft. Jeśli zostanie rozpoznany, identyfikator generuje naruszenie reguły. Przykłady wyrazów złożonych, które powodują naruszenie, to "CheckSum" i "MultiPart", które powinny być nazywane odpowiednio "Sumą kontrolną" i "Multipart". Ze względu na poprzednie typowe użycie, kilka wyjątków jest wbudowanych w regułę, a kilka pojedynczych wyrazów jest oflagowanych, takich jak "Pasek narzędzi" i "Nazwa pliku", które powinny być nazywane dwoma odrębnymi wyrazami (w tym przypadku "ToolBar" i "FileName").

Konwencje nazewnictwa zapewniają wspólny wygląd bibliotek przeznaczonych dla środowiska uruchomieniowego języka wspólnego. Zmniejsza to krzywą uczenia wymaganą dla nowych bibliotek oprogramowania i zwiększa pewność klienta, że biblioteka została opracowana przez kogoś, kto ma doświadczenie w tworzeniu kodu zarządzanego.

Jak naprawić naruszenia

Zmień nazwę tak, aby była poprawnie wpisana.

Język

Moduł sprawdzania pisowni sprawdza obecnie tylko słowniki kultury w języku angielskim. Kulturę projektu można zmienić w pliku projektu, dodając element CodeAnalysisCulture .

Na przykład:

<Project ...>
  <PropertyGroup>
    <CodeAnalysisCulture>en-AU</CodeAnalysisCulture>

Ważne

Jeśli ustawisz kulturę na inną niż kultura w języku angielskim, ta reguła analizy kodu jest dyskretnie wyłączona.

Kiedy pomijać ostrzeżenia

Można bezpiecznie pominąć ostrzeżenie z tej reguły, jeśli obie części słowa złożonego są rozpoznawane przez słownik pisowni, a intencją jest użycie dwóch wyrazów.

Zobacz też