Comment : qualifier un nom d'élément déclaré

Article
09/12/2008

Mise à jour : novembre 2007

Lorsque votre code fait référence à un élément déclaré, le compilateur Visual Basic doit établir une correspondance entre le nom indiqué dans votre référence et la déclaration appropriée de ce nom. Si l'élément est défini à l'extérieur de votre code ou si plusieurs éléments sont déclarés avec le même nom, vous devrez peut-être qualifier le nom pour permettre au compilateur de résoudre toute ambiguïté possible ou de localiser l'élément.

La qualification d'un nom revient à le faire précéder, dans votre instruction source, d'informations qui identifient l'emplacement où l'élément cible est défini. Ces informations portent le nom de chaîne de qualification. Elles peuvent inclure un ou plusieurs espaces de noms et un module, une classe ou une structure.

La chaîne de qualification doit spécifier clairement le module, la classe ou la structure qui contient l'élément cible. Le conteneur peut se trouver dans un autre élément conteneur, en général un espace de noms. Vous devrez peut-être inclure plusieurs éléments conteneurs dans la chaîne de qualification.

Pour accéder à un élément déclaré en qualifiant son nom

Déterminez l'emplacement dans lequel l'élément a été défini. Il peut s'agir d'un espace de noms, ou même d'une hiérarchie d'espaces de noms. Dans l'espace de noms de plus bas niveau, l'élément doit être contenu dans un module, une classe ou une structure.

' 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

Déterminez un chemin d'accès de qualification basé sur l'emplacement de l'élément cible. Commencez avec l'espace de noms de plus haut niveau, continuez avec l'espace de noms de plus bas niveau, puis finissez par le module, la classe ou la structure qui contient l'élément cible. Chaque élément du chemin d'accès doit contenir l'élément qui le suit.

outerSpace → innerSpace → holdsTotals → totals
Préparez la chaîne de qualification pour l'élément cible. Placez un point (.) après chaque élément dans le chemin d'accès. Votre application doit avoir accès à chaque élément de votre chaîne de qualification.
```
outerSpace.innerSpace.holdsTotals.totals.
```
Écrivez de manière normale l'instruction d'expression ou d'assignation qui fait référence à l'élément cible.
```
grandTotal = 9000
```

Placez la chaîne de qualification avant le nom de l'élément cible. Le nom doit suivre immédiatement le point (.) qui suit le module, la classe ou la structure qui contient l'élément.

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

Le compilateur utilise la chaîne de qualification pour rechercher une déclaration claire et non équivoque à laquelle il peut faire correspondre la référence de l'élément cible.

Voir aussi

Partager via

Comment : qualifier un nom d'élément déclaré

Pour accéder à un élément déclaré en qualifiant son nom

Voir aussi

Tâches

Concepts

Autres ressources

Ressources supplémentaires