CA1701: соблюдайте правильность регистра в составных словах строк ресурса

  • Статья
Товар Значение
Идентификатор правила CA1701
Категория Microsoft.Naming
Критическое изменение Не критическое

Причина

Строка ресурса содержит составное слово, которое не отображается правильно.

Примечание.

Это правило устарело. Дополнительные сведения см. в разделе "Устаревшие правила".

Описание правила

Каждое слово в строке ресурса разделено на маркеры, основанные на регистре. Каждое непрерывное сочетание двух токенов проверяется библиотекой проверки орфографии Майкрософт. При совпадении слово создает нарушение правила. Примерами составных слов, вызывающих нарушение, являются CheckSum и MultiPart, которые должны быть регистрироваться как "Контрольная сумма" и "Multipart" соответственно. Из-за предыдущего общего использования несколько исключений встроены в правило, и несколько отдельных слов помечены, такие как "Панель инструментов" и "Имя файла", которые должны быть помечены как два разных слова. В этом примере будут помечены "ToolBar" и "FileName".

Соглашения об именовании обеспечивают единство вида библиотек, предназначенных для среды CLR. Это сокращает время, необходимое для изучения новых библиотек программного обеспечения, и позволяет клиентам увериться в том, что разработчик библиотеки имеет опыт разработки управляемого кода.

Устранение нарушений

Измените слово так, чтобы оно было правильно регистрировано.

Изменение языка словаря

По умолчанию используется версия английского языка (en) орфографического проверка er. Если вы хотите изменить язык орфографии проверка er, это можно сделать, добавив один из следующих атрибутов в файл AssemblyInfo.cs или AssemblyInfo.vb:

  • Используется AssemblyCultureAttribute для указания языка и региональных параметров, если ресурсы находятся в вспомогательной сборке.
  • Используйте для NeutralResourcesLanguageAttribute указания нейтрального языка и региональных параметров сборки, если ресурсы находятся в той же сборке, что и код.

Важно!

Если задать язык и региональные параметры, отличные от языка и региональных параметров на английском языке, это правило анализа кода автоматически отключено.

Когда лучше отключить предупреждения

Это безопасно для подавления предупреждения из этого правила, если обе части составного слова распознаются словарем орфографии и намерением является использование двух слов.

Вы также можете добавить составные слова в пользовательский словарь для орфографии проверка er. Слова в пользовательском словаре не вызывают нарушений. Дополнительные сведения см. в разделе "Практическое руководство. Настройка словаря анализа кода".

См. также