Поделиться через

Соглашения об именовании Visual Basic

При названии элемента в приложении Visual Basic первый символ этого имени должен быть алфавитным символом или символом подчеркивания. Обратите внимание, что имена, начинающиеся с подчеркивания, не соответствуют независимости языка и Language-Independent компонентам (CLS).

К именованию применяются следующие предложения.

  • Начните каждое отдельное слово в имени с прописной буквы, как, например, в FindLastRecord и RedrawMyForm.

  • Начинайте имена функций и методов с глагола, как в InitNameArray или CloseDialog.

  • Начать класс, структуру, модуль и имена свойств с существительным, как в EmployeeName или CarAccessory.

  • Начните имена интерфейсов с префиксом "I", за которым следует существительная или существительная фраза, например IComponent, или с прилагательным, описывающим поведение интерфейса, например IPersistable. Не используйте подчеркивание и используйте аббревиатуры умеренно, так как сокращения могут вызвать путаницу.

  • Начните имена обработчиков событий с существительным, описывающим тип события, за которым следует суффикс "EventHandler", как в "MouseEventHandler".

  • В именах классов аргументов событий включите суффикс "EventArgs".

  • Если событие имеет понятие "до" или "после", используйте суффикс в настоящем или прошлом времени, как в "ControlAdd" или "ControlAdded".

  • Для длительных или часто используемых терминов используйте сокращенные выражения, чтобы сохранить длину имен разумной, например HTML, а не "Язык гипертекстовой разметки". Как правило, имена переменных, превышающие 32 символа, трудно читать на мониторе с низким разрешением. Кроме того, убедитесь, что сокращения согласованы во всем приложении. Случайное переключение проекта между HTML и гипертекстовой разметкой может привести к путанице.

  • Избегайте использования имен во внутренней области, которые совпадают с именами во внешней области. Ошибки могут возникнуть, если обращение происходит к неправильной переменной. Если возникает конфликт между переменной и ключевым словом того же имени, необходимо идентифицировать ключевое слово, предваряя его соответствующей библиотекой типов. Например, если у вас есть переменная Date, можно использовать встроенную Date функцию только путем вызова DateTime.Date.

См. также