Shadows (Visual Basic)

Article
08/10/2011

Spécifie qu'un élément de programmation déclaré redéclare et masque un élément de programmation de même nom ou définit un ensemble d'éléments surchargés, dans une classe de base.

Notes

Le principal objectif de l'occultation (qui est également appelée masquage par nom) est de conserver la définition de vos membres de classe. La classe de base peut subir un changement qui crée un élément du même nom que celui que vous avez déjà défini. Dans ce cas, le modificateur Shadows oblige les références de votre classe à être résolues vers le membre que vous avez défini, et non vers le nouvel élément de la classe de base.

L'occultation et la substitution redéfinissent toutes les deux un élément hérité, mais les deux approches sont significativement différentes. Pour plus d'informations, consultez Occultation dans Visual Basic.

Règles

Contexte de déclaration. Vous pouvez utiliser Shadows seulement au niveau de la classe. Cela signifie que le contexte de déclaration pour un élément Shadows doit être une classe et ne peut pas être un fichier source, un espace de noms, une interface, un module, une structure ou une procédure.

Vous ne pouvez déclarer qu'un élément d'occultation dans une seule instruction de déclaration.
Modificateurs combinés. Vous ne pouvez pas spécifier Shadows avec Overloads, Overrides ou Static dans la même déclaration.
Types d'éléments. Vous pouvez occulter tout type d'élément déclaré par un autre type. Si vous masquez une propriété ou une procédure avec une autre propriété ou procédure, les paramètres et le type retourné n'ont pas besoin de correspondre à ceux de la propriété ou de la procédure de la classe de base.
Accès. L'élément occulté dans la classe de base n'est normalement pas disponible dans la classe dérivée qui l'occulte. Cependant, les considérations suivantes s'appliquent :
- Si l'élément d'occultation n'est pas disponible à partir du code qui s'y réfère, la référence correspond à l'élément occulté. Par exemple, si un élément Private occulte un élément de classe de base, le code qui n'est pas autorisé à accéder à l'élément Private accède à la place à l'élément de classe de base.
- Si vous occultez un élément, vous pouvez toujours accéder à l'élément occulté par l'intermédiaire d'un objet déclaré avec le type de classe de base. Vous pouvez également y accéder par l'intermédiaire de MyBase.