Nombres de elementos declarados (Visual Basic)Declared Element Names (Visual Basic)

Cada elemento declarado tiene un nombre, también denominado una identificador, que es lo que el código que se usa para hacer referencia a él.Every declared element has a name, also called an identifier, which is what the code uses to refer to it.

ReglasRules

El nombre de un elemento en Visual Basic debe observar las reglas siguientes:An element name in Visual Basic must observe the following rules:

  • Debe comenzar con un carácter alfabético o un carácter de subrayado (_).It must begin with an alphabetic character or an underscore (_).

  • Solo debe contener caracteres alfabéticos, dígitos decimales y caracteres de subrayado.It must only contain alphabetic characters, decimal digits, and underscores.

  • Debe contener al menos un carácter alfabético o dígito decimal si empieza con un carácter de subrayado.It must contain at least one alphabetic character or decimal digit if it begins with an underscore.

  • No debe superar los 1023 caracteres.It must not be more than 1023 characters long.

La longitud máxima de 1023 caracteres también se aplica a toda la cadena de un nombre completo, como outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.The length limit of 1023 characters also applies to the entire string of a fully qualified name, such as outerNamespace.middleNamespace.innerNamespace.thisClass.thisElement.

El ejemplo siguiente muestra algunos nombres de elemento válido.The following example shows some valid element names.

aB123__45

_567

El ejemplo siguiente muestra algunos nombres de elemento no válido.The following example shows some invalid element names. El primero contiene sólo un carácter de subrayado, la segunda comienza con un dígito decimal y el tercero contiene un carácter no válido ($).The first contains only an underscore, the second begins with a decimal digit, and the third contains an invalid character ($).

' Three INVALID element names

_

12ABC

xyz$wv

Precaución

Los nombres de elemento a partir de un carácter 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 utilizar un componente que define los nombres de este tipo.Element names starting with an underscore (_) are not part of the Language Independence and Language-Independent Components (CLS), so CLS-compliant code cannot use a component that defines such names. Sin embargo, un carácter de subrayado en cualquier otra posición de un nombre de elemento es conforme a CLS.However, an underscore in any other position in an element name is CLS-compliant.

Directrices de longitud de nombreName Length Guidelines

A efectos prácticos, su nombre debe ser lo más corta posible al identificar claramente la naturaleza del elemento.As a practical matter, your name should be as short as possible while still clearly identifying the nature of the element. Esto mejora la legibilidad del código y reduce el tamaño de archivo de origen y de longitud de línea.This improves the readability of your code and reduces line length and source-file size.

Por otro lado, el nombre no debe ser tan corto que no adecuadamente describe lo que representa el elemento y cómo lo utiliza el código.On the other hand, your name should not be so short that it does not adequately describe what the element represents and how your code uses it. Esto es importante para la legibilidad del código.This is important for the readability of your code. Si alguien más está intentando entenderla, o si usted está examinando mucho tiempo después de que lo escribió, nombres de elementos adecuados pueden guardar una cantidad considerable de tiempo.If somebody else is trying to understand it, or if you yourself are looking at it a long time after you wrote it, suitable element names can save a considerable amount of time.

Nombres de escapeEscaped Names

Por lo general, un nombre de elemento no debe coincidir con cualquiera de las palabras clave reservadas, como Visual Basic, Case o Friend.Generally, an element name must not match any of the keywords reserved by Visual Basic, such as Case or Friend. Sin embargo, puede definir un nombre con escape, que se encierra entre corchetes ([ ]).However, you can define an escaped name, which is enclosed by brackets ([ ]). Un nombre con escape puede coincidir con cualquier palabra clave de Visual Basic, puesto que los corchetes quitar cualquier ambigüedad.An escaped name can match any Visual Basic keyword, since the brackets remove any ambiguity. También utiliza los corchetes cuando se hace referencia al nombre más adelante en el código.You also use the brackets when you refer to the name later in your code.

En general, debe usar nombres de escape solo cuando:In general, you should use escaped names only when:

  • El código se migrado desde una versión anterior de Visual Basic que no reservó la palabra clave que se va a usar como un nombre; oYour code has migrated from a previous version of Visual Basic that did not reserve the keyword being used as a name; or

  • Trabaja con código escrito en otro idioma en el que no se reserva la palabra clave dada.You are working with code written in another language in which the given keyword is not reserved.

De lo contrario, considere cambiar el nombre del elemento si su nombre entra en conflicto con una palabra clave.Otherwise, you should consider renaming the element if its name conflicts with a keyword. El entorno de desarrollo integrado (IDE) proporciona una manera fácil de hacerlo.The integrated development environment (IDE) provides an easy way to do this. Para obtener más información, consulte refactorización.For more information, see Refactoring.

Mayúsculas y minúsculas en nombresCase Sensitivity in Names

Los nombres de elemento en Visual Basic distinguen entre mayúsculas y minúsculas.Element names in Visual Basic are case-insensitive. Esto significa que cuando el compilador compara dos nombres que difieran en mayúsculas o minúsculas, interpreta como el mismo nombre.This means that when the compiler compares two names that differ in alphabetic case only, it interprets them as the same name. Por ejemplo, considera que ABC y abc hacen referencia al mismo elemento declarado.For example, it considers ABC and abc to refer to the same declared element.

Sin embargo, common language runtime (CLR) usa el enlace entre mayúsculas y minúsculas.However, the common language runtime (CLR) uses case-sensitive binding. 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.Therefore, when you produce an assembly or a DLL and make it available to other assemblies, your names are no longer case-insensitive. 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.For example, if you define a class with an element called ABC, and other assemblies make use of your class through the common language runtime, they must refer to the element as ABC. Si posteriormente vuelve a compilar la clase y cambiar el nombre del elemento a abc, los demás ensamblados mediante la clase ya no pudieran acceder a ese elemento.If you subsequently recompile your class and change the element's name to abc, the other assemblies using your class could no longer access that element. 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.Therefore, when you release an updated version of an assembly, you should not change the alphabetic case of any public elements.

Los nombres y las configuraciones regionalesNames and Locales

Comparación de nombres es independiente de la configuración regional.Comparison of names is independent of locale. Si dos nombres coinciden en una configuración regional, se garantiza que deben coincidir en todas las configuraciones regionales.If two names match in one locale, they are guaranteed to match in all locales.

Vea tambiénSee also