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

Объявленные имена элементов (Visual Basic)

Каждый объявленный элемент имеет имя, также называемое идентификатором, который является тем, что код использует для ссылки на него.

Правила

Имя элемента в Visual Basic должно соблюдать следующие правила:

  • Он должен начинаться с алфавитного символа или подчеркивания (_).

  • Он должен содержать только алфавитные символы, десятичные цифры и символы подчеркивания.

  • Он должен содержать по крайней мере один буквенный символ или десятичную цифру, если он начинается с подчеркивания.

  • Оно не должно превышать 1023 символов.

Ограничение длины 1023 символов также применяется ко всей строке полного имени, например outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

В следующем примере показаны некоторые допустимые имена элементов.

aB123__45

_567

В следующем примере показаны некоторые недопустимые имена элементов. Первая содержит только знак подчеркивания, второй начинается с десятичной цифры, а третий содержит недопустимый символ ($).

' Three INVALID element names

_

12ABC

xyz$wv

Осторожность

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

Рекомендации по длине имен

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

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

Экранированные имена

Как правило, имя элемента не должно соответствовать ни одному из ключевых слов, зарезервированных Visual Basic, например Case или Friend. Однако можно определить escape-имя, которое заключено в скобки ([ ]). Экранированное имя может соответствовать любому ключевому слову Visual Basic, так как скобки удаляют любую неоднозначность. Вы также используете квадратные скобки при ссылке на имя позже в коде.

Как правило, следует использовать escape-имена только в том случае, если:

  • Код перенесен из предыдущей версии Visual Basic, которая не зарезервировала ключевое слово, используемое в качестве имени; или

  • Вы работаете с кодом, написанным на другом языке, в котором заданное ключевое слово не зарезервировано.

В противном случае следует рассмотреть вопрос о переименовании элемента, если его имя конфликтует с ключевым словом. Интегрированная среда разработки (IDE) предоставляет простой способ сделать это. Дополнительные сведения см. в разделе "Рефакторинг".

Чувствительность к регистру в именах

Имена элементов в Visual Basic не учитывает регистр. Это означает, что если компилятор сравнивает два имени, которые отличаются только в алфавитном регистре, он интерпретирует их как одно и то же имя. Например, он считает, что ABC и abc ссылаются на один и тот же объявленный элемент.

Однако среда CLR использует чувствительную к регистру привязку. Поэтому при создании сборки или библиотеки DLL и ее доступности для других сборок имена перестают быть регистрозависимыми. Например, если вы определяете класс с элементом под названием ABC, а другие сборки используют ваш класс через общую среду выполнения языка CLR, они должны ссылаться на элемент как ABC. Если вы впоследствии перекомпилируете класс и измените имя abcэлемента на, другие сборки, использующие класс, больше не смогут получить доступ к такому элементу. Поэтому при выпуске обновленной версии сборки не следует изменять алфавитный регистр каких-либо общедоступных элементов.

Имена и местоположения

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

См. также