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.
Powiązane reguły
- CA1701: Wyrazy złożone ciągu zasobu powinny mieć prawidłową wielkość liter
- CA1709: Identyfikatory powinny mieć prawidłową wielkość liter
- CA1708: Identyfikatory powinny różnić się nie tylko wielkością liter
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla