Freigeben über

CA1701: Bei zusammengesetzten Begriffen in Ressourcenzeichenfolgen sollte die Groß-/Kleinschreibung beachtet werden.

  • Artikel
Element Wert
RuleId CA1701
Category Microsoft.Naming
Unterbrechende Änderung Nicht unterbrechend

Ursache

Eine Ressourcenzeichenfolge enthält einen zusammengesetzten Begriff, der offenbar eine falsche Groß- und Kleinschreibung aufweist.

Hinweis

Diese Regel wurde als veraltet markiert. Weitere Informationen finden Sie unter Veraltete Regeln.

Regelbeschreibung

Jeder Begriff in der Ressourcenzeichenfolge wird basierend auf der Groß-/Kleinschreibung in einzelne Token unterteilt. Jede zusammenhängende Kombination aus zwei Token wird durch die Rechtschreibprüfung aus der Microsoft-Bibliothek überprüft. Wenn der Begriff erkannt wird, erzeugt er 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 Sprachgebrauchs 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 Beispiel würden „ToolBar“ und „FileName“ markiert werden.

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 das Wort so ab, dass es die richtige Groß-/Kleinschreibung verwendet.

Ändern der Wörterbuchsprache

Standardmäßig wird die englische (en) Version der Rechtschreibprüfung verwendet. Wenn Sie die Sprache der Rechtschreibprüfung ändern möchten, fügen Sie Ihrer Datei AssemblyInfo.cs oder AssemblyInfo.vb eines der folgenden Attribute hinzu:

  • Verwenden Sie AssemblyCultureAttribute, um die Kultur anzugeben, wenn sich Ihre Ressourcen in einer Satellitenassembly befinden.
  • Verwenden Sie NeutralResourcesLanguageAttribute, um die neutrale Kultur Ihrer Assembly anzugeben, wenn sich Ihre Ressourcen und Ihr Code in derselben Assembly befinden.

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.

Sie können zusammengesetzte Begriffe auch in ein benutzerdefiniertes Wörterbuch für die Rechtschreibprüfung aufnehmen. Wörter im Benutzerwörterbuch verursachen keine Verstöße. Weitere Informationen finden Sie unter Gewusst wie: Anpassen des Codeanalysewörterbuchs.

Weitere Informationen