Partilhar via


Como: Qualificar um nome de elemento declarado

Quando o seu código se refere a um elemento declarado, o compilador Visual Basic precisa equiparar o nome na sua referência com a declaração adequada daquele nome.Se o elemento está definido fora de seu código, ou se mais de um elemento está declarado com o mesmo nome, você pode precisar capacitar o nome para permitir ao compilador resolver qualquer possível problema de ambiguidade ou localizar o elemento.

Classificar um nome significa precedê-lo na sua declração-fonte com informações que identificam onde o elemento-alvo está definido.Esta informação é chamada uma cadeia de caracteres de classificação.Pode incluir um ou mais namespaces e um módulo, classe ou estrutura.

A cadeia de caracteres de classificação deve especificar, de forma não ambígua, o módulo, classe ou estrutura contendo o elemento alvo.O contêiner pode ser colocado por vez em um outro contendo elemento, normalmente um namespace.Você pode precisar incluir vários elementos continentes na cadeia de caracteres de classificação.

Para acessar um elemento declarado classificando seu nome

  1. Determine a localização na qual o elemento foi definido.Pode incluir um namespace, ou mesmo uma hierarquia de namespaces.Dentro do namespace de menor nível, o elemento precisa estar incluído num módulo, classe ou estrutura.

    ' 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 o caminho de classificação na localização do elemento-alvo.Inicie com o namespace de maior nível, prossiga para o de menor nível, e finalize com o módulo, classe ou estrutura contendo o elemento-alvo.Cada elemento no caminho deve conter um elemento que o segue.

    outerSpace → innerSpace → holdsTotals → totals

  3. Prepare a cadeia de caracteres de classificação para o elemento-alvo.Coloque um ponto final (.) depois de todo elemento no caminho.Seu aplicativo precisa ter acesso a todos os elementos de sua cadeia de caracteres de classificação.

    outerSpace.innerSpace.holdsTotals.totals.
    
  4. Escreva a expressão ou afirmação de designação referindo-se ao elemento-alvo de modo normal.

    grandTotal = 9000
    
  5. Coloque a cadeia de caracteres de classificação à frente do nome do elemento-alvo.O nome deve seguir imediatamente o ponto final (.) que segue o módulo, classe ou estrutura que contém o 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. O compilador usa a cadeia de caracteres de classificação para achar uma declaração clara e livre de ambiguidades para a qual ele possa equiparar à referência do elemento-alvo.

Consulte também

Tarefas

Como: Distinguir entre dois elementos com o mesmo nome

Como: Ocultar uma variável com o mesmo nome sistema autônomo a variável

Como: Ocultar uma variável herdada

Como: Acessar uma variável oculto por uma classe derivada

Conceitos

Características do elemento declarado

Resolvendo uma Referência Quando Várias Variáveis Têm o Mesmo Nome

Declaração de instruções em Visual Basic

Outros recursos

Referências aos elementos declaradas