CA1702: Bei zusammengesetzten Begriffen sollte die Groß-/Kleinschreibung beachtet werden.
Element | Wert |
---|---|
RuleId | CA1702 |
Category | Microsoft.Naming |
Unterbrechende Änderung | Breaking: wenn für Assemblys ausgelöst Nonbreaking: wenn für Typparameter ausgelöst |
Ursache
Der Name eines Bezeichners enthält mehrere Begriffe, und mindestens einer der Begriffe ist anscheinend ein zusammengesetztes Wort mit falscher Groß-/Kleinschreibung.
Hinweis
Diese Regel wurde als veraltet markiert. Weitere Informationen finden Sie unter Veraltete Regeln.
Regelbeschreibung
Der Name des Bezeichners ist in Wörter unterteilt, die auf der Groß- und Kleinschreibung basieren. Jede zusammenhängende Kombination aus zwei Wörtern wird durch die Rechtschreibprüfung der Microsoft-Bibliothek überprüft. Wenn das Wort erkannt wird, erzeugt der Bezeichner einen Regelverstoß. Beispiele für zusammengesetzte Wörter, die einen Verstoß verursachen, sind "CheckSum" und "MultiPart", deren Schreibung "Checksum" bzw. "Multipart" lauten sollte. Aufgrund des früher üblichen Gebrauchs enthält die Regel verschiedene Ausnahmen, und es werden mehrere Einzelwörter gekennzeichnet, z. B. "Toolbar" und "Filename", die als zwei verschiedene Wörter geschrieben werden sollten – in diesem Fall "ToolBar" und "FileName".
Durch Benennungskonventionen erhalten Bibliotheken, die auf die Common Language Runtime abzielen, ein einheitliches Erscheinungsbild. Dadurch wird der Lernaufwand für neue Softwarebibliotheken verringert. Zudem wird das Kundenvertrauen dahingehend gestärkt, dass die Bibliothek von einem erfahrenen Entwickler für verwalteten Code erstellt wurde.
Behandeln von Verstößen
Ändern Sie den Namen so, dass die Groß-/Kleinschreibung korrekt ist.
Sprache
Die Rechtschreibprüfung erfolgt derzeit nur auf Grundlage englischsprachiger Wörterbücher. Sie können die Sprachkultur Ihres Projekts in der Projektdatei ändern, indem Sie das CodeAnalysisCulture-Element hinzufügen.
Beispiel:
<Project ...>
<PropertyGroup>
<CodeAnalysisCulture>en-AU</CodeAnalysisCulture>
Wichtig
Wenn Sie eine andere als die auf Englisch basierende Kultur festlegen, wird diese Codeanalyseregel ohne Hinweis deaktiviert.
Wann sollten Warnungen unterdrückt werden?
Eine durch diese Regel ausgelöste Warnung kann problemlos unterdrückt werden, wenn beide Teile des zusammengesetzten Begriffs vom Wörterbuch für die Rechtschreibung erkannt werden und die Verwendung von zwei Wörtern beabsichtigt ist.
Ähnliche Regeln
- CA1701: Bei zusammengesetzten Begriffen in Ressourcenzeichenfolgen sollte die Groß-/Kleinschreibung beachtet werden.
- CA1709: Bei Bezeichnern sollte die Groß-/Kleinschreibung beachtet werden.
- CA1708: Bezeichner sollten sich nicht nur durch die Groß-/Kleinschreibung unterscheiden.
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für