Nombres de elementos declarados (Visual Basic)

Cada elemento declarado tiene un nombre, también denominado identificador, que es lo que usa el código para hacer referencia a él.

Reglas

Un nombre de elemento en Visual Basic debe respetar las reglas siguientes:

  • Debe comenzar por un carácter alfabético o un signo de subrayado (_).

  • Solo debe contener caracteres alfabéticos, dígitos decimales y signos de subrayado.

  • Debe contener al menos un carácter alfabético o un dígito decimal si comienza con un signo de subrayado.

  • No debe tener más de 1023 caracteres de longitud.

El límite de longitud de 1023 caracteres también se aplica a toda la cadena de un nombre completo, como outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

En el ejemplo siguiente se muestran algunos nombres de elemento válidos.

aB123__45

_567

En el ejemplo siguiente se muestran algunos nombres de elemento no válidos. El primero contiene solo un signo de subrayado, el segundo comienza con un dígito decimal y el tercero contiene un carácter no válido ($).

' Three INVALID element names

_

12ABC

xyz$wv

Precaución

Los nombres de elementos que empiezan por un signo de subrayado (_) no forman parte de la Independencia del lenguaje y componentes independientes del lenguaje (CLS), por lo que el código conforme a CLS no puede usar un componente que defina dichos nombres. Sin embargo, un signo de subrayado en cualquier otra posición de un nombre de elemento es conforme a CLS.

Directrices de longitud de nombre

Como cuestión práctica, el nombre debe ser lo más corto posible para identificar claramente la naturaleza del elemento. Esto mejora la legibilidad del código y reduce la longitud de línea y el tamaño del archivo de origen.

Por otro lado, el nombre no debe ser demasiado corto y no describir adecuadamente lo que representa el elemento y cómo lo usa el código. Esto es importante para la legibilidad del código. Si alguien más está intentando entenderlo, o si usted lo consulta mucho tiempo después de escribirlo, los nombres de elemento adecuados pueden ahorrar una cantidad de tiempo considerable.

Nombres de escape

Por lo general, un nombre de elemento no debe coincidir con ninguna de las palabras clave reservadas por Visual Basic, como Case o Friend. Sin embargo, puede definir un nombre de escape, que se incluye entre corchetes ([ ]). Un nombre de escape puede coincidir con cualquier palabra clave de Visual Basic, ya que los corchetes quitan cualquier ambigüedad. También se usan los corchetes al hacer referencia al nombre más adelante en el código.

En general, solo debe usar nombres de escape cuando:

  • El código se ha migrado de una versión anterior de Visual Basic que no reservó la palabra clave que se usa como nombre; O

  • Está trabajando con código escrito en otro lenguaje en el que la palabra clave especificada no está reservada.

De lo contrario, debe considerar cambiar el nombre del elemento si su nombre entra en conflicto con una palabra clave. El entorno de desarrollo integrado (IDE) proporciona una manera sencilla de hacerlo. Para más información, vea Refactorización.

Distinción entre mayúsculas y minúsculas en nombres

Los nombres de elementos de Visual Basic no distinguen mayúsculas de minúsculas. Esto significa que, cuando el compilador compara dos nombres que solo difieren en mayúsculas y minúsculas, los interpreta como el mismo nombre. Por ejemplo, considera que ABC y abc hacen referencia al mismo elemento declarado.

Sin embargo, Common Language Runtime (CLR) usa enlaces que distinguen entre mayúsculas y minúsculas . Por lo tanto, cuando genere un ensamblado o una DLL que pueda estar disponible para otros ensamblados, sus nombres ya no distinguirán entre mayúsculas o minúsculas. Por ejemplo, si define una clase que tiene un elemento denominado ABC, y otros ensamblados usan la clase mediante Common Language Runtime, deberán hacer referencia al elemento como ABC. Si, posteriormente, vuelve a compilar la clase y cambia el nombre del elemento a abc, los otros ensamblados que usen la clase ya no tendrán acceso a este elemento. Por lo tanto, cuando se lance una versión actualizada de un ensamblado, no se deben cambiar las mayúsculas o minúsculas de los elementos públicos.

Nombres y configuraciones regionales

La comparación de nombres es independiente de la configuración regional. Si dos nombres coinciden en una configuración regional, se garantiza que coincidan en todas las configuraciones regionales.

Consulte también