Promotion de type
Mise à jour : novembre 2007
Lorsque vous déclarez un élément de programmation dans un module, Visual Basic élève sa portée vers l'espace de noms contenant le module. Ce concept porte le nom de promotion de type.
L'exemple suivant montre une définition squelette d'un module et de deux membres de ce module.
Namespace projNamespace
Module projModule
Public Enum basicEnum As Integer
one = 1
two = 2
End Enum
Public Class innerClass
Public Sub numberSub(ByVal firstArg As Integer)
End Sub
End Class
End Module
End Namespace
Dans projModule, les éléments de programmation déclarés au niveau du module sont promus vers projNamespace. Dans l'exemple précédent, basicEnum et innerClass sont promus, mais numberSub ne l'est pas, parce qu'il n'est pas déclaré au niveau du module.
Effet de la promotion de type
Grâce à la promotion de type, une chaîne de qualification n'a pas besoin d'inclure le nom du module. L'exemple suivant effectue deux appels à la procédure de l'exemple précédent.
Sub usePromotion()
projNamespace.projModule.innerClass.numberSub(projNamespace.projModule.basicEnum.one)
projNamespace.innerClass.numberSub(projNamespace.basicEnum.two)
End Sub
Dans l'exemple précédent, le premier appel utilise des chaînes de qualification complètes. Toutefois, cela n'est pas nécessaire du fait de la promotion de type. Le deuxième appel accède également aux membres du module sans inclure projModule dans les chaînes de qualification.
Invalidation de la promotion de type
Si l'espace de noms possède déjà un membre portant le même nom qu'un membre de module, la promotion de type est invalidée pour ce membre de module. L'exemple suivant montre une définition squelette d'une énumération et d'un module dans le même espace de noms.
Namespace thisNamespace
Public Enum abc
first = 1
second
End Enum
Module thisModule
Public Class abc
Public Sub abcSub()
End Sub
End Class
Public Class xyz
Public Sub xyzSub()
End Sub
End Class
End Module
End Namespace
Dans l'exemple précédent, Visual Basic ne peut pas promouvoir la classe abc vers thisNameSpace parce qu'il existe déjà une énumération du même nom au niveau de l'espace de noms. Pour accéder à abcSub, vous devez utiliser la chaîne de qualification complète thisNamespace.thisModule.abc.abcSub. Toutefois, la classe xyz est promue et vous pouvez accéder à xyzSub à l'aide de la chaîne de qualification plus courte thisNamespace.xyz.xyzSub.
Invalidation de la promotion de type pour les types partiels
Si une classe ou une structure à l'intérieur d'un module utilise le mot clé Partial (Visual Basic), la promotion de type est automatiquement invalidée pour cette classe ou cette structure, que l'espace de noms possède ou non un membre du même nom. D'autres éléments dans le module restent disponibles pour la promotion de type.
Conséquences. L'invalidation de la promotion de type d'une définition partielle peut provoquer des résultats inattendus et même des erreurs de compilation. L'exemple suivant montre des définitions squelettes partielles d'une classe, dont l'une se trouve à l'intérieur d'un module.
Namespace sampleNamespace
Public Partial Class sampleClass
Public Sub sub1()
End Sub
End Class
Module sampleModule
Public Partial Class sampleClass
Public Sub sub2()
End Sub
End Class
End Module
End Namespace
Dans l'exemple précédent, le développeur peut s'attendre à ce que le compilateur fusionne les deux définitions partielles de sampleClass. Toutefois, le compilateur n'envisage pas de promotion pour la définition partielle à l'intérieur de sampleModule. En conséquence, il essaie de compiler deux classes distinctes et séparées, intitulées sampleClass, mais avec des chemins d'accès de qualification différents.
Le compilateur fusionne des définitions partielles uniquement lorsque leurs chemins qualifiés complets sont identiques.
Recommandations
Les recommandations suivantes correspondent à une bonne approche en matière de programmation.
Noms uniques. Lorsque vous contrôlez totalement l'attribution des noms aux éléments de programmation, il est toujours recommandé d'utiliser des noms uniques partout. Les noms identiques requièrent une qualification supplémentaire et peuvent compliquer la lecture de votre code. Ils sont également la source de petites erreurs et de résultats inattendus.
Qualification complète. Lorsque vous travaillez avec des modules et d'autres éléments dans le même espace de noms, l'approche la plus sûre consiste à toujours utiliser la qualification complète pour tous les éléments de programmation. Si la promotion de type est invalidée pour un membre de module et que vous n'appliquez pas une qualification complète à ce membre, vous pouvez accéder par inadvertance à un élément de programmation différent.
Voir aussi
Tâches
Comment : contrôler la portée d'une variable
Concepts
Résolution d'une référence lorsque plusieurs variables ont le même nom