Compartir a través de

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 observar las reglas siguientes:

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

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

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

  • No debe tener más de 1023 caracteres.

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 carácter 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 comienzan por un carácter de subrayado (_) no forman parte de language Independence y Language-Independent Components (CLS), por lo que el código compatible con CLS no puede usar un componente que defina dichos nombres. Sin embargo, un carácter de subrayado en cualquier otra posición de un nombre de elemento es compatible con CLS.

Directrices de longitud de nombre

Como cuestión práctica, su nombre debe ser lo más corto posible mientras sigue identificando 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 tan corto que no describa 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á tratando de entenderlo, o si usted lo está mirando mucho tiempo después de escribirlo, los nombres de elementos adecuados pueden ahorrar una cantidad considerable de tiempo.

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 fácil de hacerlo. Para obtener más información, consulte 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 alfabéticas, los interpreta como el mismo nombre. Por ejemplo, considera ABC y abc hace 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 con un elemento denominado ABCy otros ensamblados hacen uso de la clase a través de Common Language Runtime, deben hacer referencia al elemento como ABC. Si posteriormente vuelve a compilar la clase y cambia el nombre del elemento a abc, los demás ensamblados que usan la clase ya no pudieron tener acceso a ese elemento. Por lo tanto, al publicar una versión actualizada de un ensamblado, no debe cambiar el caso alfabético de ningún elemento público.

Nombres y ubicaciones

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