Имена объявленных типов (Visual Basic)

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

Правила

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

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

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

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

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

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

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

aB123__45

_567

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

' Three INVALID element names

_

12ABC

xyz$wv

Внимание

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

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

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

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

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

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

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

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

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

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

Конфиденциальность регистра в именах

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

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

Имена и языковые параметры

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

См. также