Cómo: Calificar el nombre de un elemento declarado

Actualización: noviembre 2007

Si un código hace referencia a un elemento declarado, el compilador Visual Basic debe hacer coincidir el nombre de la referencia con la declaración pertinente del nombre. Si el elemento está definido fuera del código o si hay más de un elemento declarado con el mismo nombre, es posible que necesite calificar el nombre para permitir al compilador resolver cualquier posible ambigüedad o buscar el elemento.

Calificar un nombre significa que hay que hacerlo preceder en la instrucción de origen con información que identifique dónde se ha definido el elemento de destino. Esta información se denomina cadena de la calificación. Puede incluir uno o más espacios de nombres y un módulo, clase o estructura.

La cadena de la calificación debe especificar de forma inequívoca el módulo, clase o estructura que contiene el elemento de destino. Se puede buscar a su vez el contenedor en otro elemento contenedor, normalmente un espacio de nombres. Es posible que necesite incluir varios elementos contenedores en la cadena de la calificación.

Para tener acceso a un elemento declarado mediante la calificación de su nombre

  1. Determine la ubicación en la que se ha definido el elemento. Esto puede incluir un espacio de nombres o incluso una jerarquía de espacios de nombres. Dentro del espacio de nombres de nivel inferior, el elemento debe estar contenido en un módulo, clase o estructura.

    ' Assume the following hierarchy exists outside your code.
Namespace outerSpace
    Namespace innerSpace
        Module holdsTotals
            Public Structure totals
                Public thisTotal As Integer
                Public Shared grandTotal As Long
            End Structure
        End Module
    End Namespace
End Namespace

  2. Determine una ruta de acceso de calificación basada en la ubicación del elemento de destino. Comience con el espacio de nombres de nivel superior, continúe con el espacio de nombres de nivel inferior y termine con el módulo, clase o estructura que contiene el elemento de destino. Cada elemento en la ruta de acceso debe contener el elemento que le sigue.

    outerSpace → innerSpace → holdsTotals → totals

  3. Prepare la cadena de la calificación para el elemento de destino. Coloque un punto (.) después de cada elemento en la ruta de acceso. Su aplicación debe tener acceso a cada elemento en la cadena de la calificación.

    outerSpace.innerSpace.holdsTotals.totals.

  4. Escriba la expresión o instrucción de asignación que hace referencia al elemento de destino de la manera normal.

    grandTotal = 9000

  5. Preceda el nombre del elemento de destino con la cadena de la calificación. El nombre debe ir inmediatamente después del punto (.) que sigue al módulo, clase o estructura que contiene el elemento.

    ' Assume the following module is part of your code.
Module accessGrandTotal
    Public Sub setGrandTotal()
        outerSpace.innerSpace.holdsTotals.totals.grandTotal = 9000
    End Sub
End Module

  6. El compilador utiliza la cadena de la calificación para encontrar una declaración clara e inequívoca con la que puede hacer coincidir la referencia del elemento de destino.

Vea también

Tareas

Cómo: Distinguir entre dos elementos con el mismo nombre

Cómo: Ocultar una variable con el mismo nombre que su variable

Cómo: Ocultar una variable heredada

Cómo: Obtener acceso a una variable que oculta una clase derivada

Conceptos

Características de los elementos declarados

Resolver una referencia cuando muchas variables tienen el mismo nombre

Instrucciones de declaración en Visual Basic

Otros recursos

Referencias a elementos declarados

  • Last updated on