Имена объявленных элементов

Статья
11/05/2008

Обновлен: Ноябрь 2007

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

Правила

При задании имени элемента в Visual Basic необходимо соблюдать следующие правила:

Имя должно начинаться с символа латинского алфавита или знака подчеркивания (_).
Имя может содержать только символы латинского алфавита, десятичные цифры и знаки подчеркивания.
Имя должно содержать хотя бы один символ латинского алфавита или десятичную цифру, если оно начинается со знака подчеркивания.
Длина имени не должна превышать 1023 символа.

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

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

aB123__45

_567

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

' Three INVALID element names

12ABC

xyz$wv

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

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

Escape-имена

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

Вообще, escape-имена следует использовать только в следующих случаях:

выполнена миграция кода из предыдущей версии Visual Basic, в которой не было зарезервировано ключевое слово, используемое в качестве имени элемента; или
Вы работаете с кодом, написанном на другом языке, в котором заданное ключевое слово не зарезервировано.

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

Учет регистра в именах

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

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