Comment : ajouter des champs et des propriétés à une classe

Mise à jour : novembre 2007

Vous pouvez avoir recours aux champs et aux propriétés pour stocker des informations dans un objet. Bien que les champs et les propriétés soient difficiles à distinguer du point de vue de l'application cliente, ils diffèrent eu égard à la manière dont ils sont déclarés au sein d'une classe. Les champs sont tout simplement des variables publiques exposées par une classe, alors que les propriétés utilisent des procédures Property pour contrôler la façon dont les valeurs sont définies ou retournées.

Pour ajouter un champ à une classe

• Déclarez une variable publique dans la définition de la classe, comme l'illustre le code suivant :

  Class ThisClass
      Public ThisField As String
  End Class
  

Pour ajouter une propriété à une classe

1. Déclarez une variable locale dans la classe pour y stocker la valeur de propriété. Cette étape est requise car les propriétés en elles-mêmes n'allouent pas de l'espace de stockage. Pour empêcher que leurs valeurs ne soient modifiées directement, les variables employées pour stocker des valeurs de propriété doivent être déclarées Private.

2. Faites précéder les déclarations de propriété par des modificateurs, comme Public et Shared, en fonction des cas. Utilisez le mot clé Property pour déclarer le nom de la propriété et déclarez le type de données que la propriété stocke et retourne.

3. Définissez des procédures de propriétés Get et Set dans la définition de propriété. Les procédures de propriétés Get s'emploient pour retourner la valeur d'une propriété et sont à peu près l'équivalent des fonctions du point de vue de la syntaxe. Elles n'acceptent pas d'arguments et peuvent être utilisées pour retourner la valeur de variables locales privées déclarées dans la classe utilisée pour stocker la valeur de propriété. Les procédures de propriétés Set sont utilisées pour définir la valeur d'une propriété ; elles ont un paramètre, généralement nommé Value, avec le même type de données que la propriété elle-même. Chaque fois que la valeur de la propriété change, le paramètre Value est passé à la procédure de propriété Set, où il peut être validé et stocké dans une variable locale.

4. Terminez les procédures de propriétés Get et Set avec des instructions End Get et End Set selon les besoins.

5. Terminez le bloc de propriété par une instruction End Property.

   Remarque :
   Si vous travaillez dans l'environnement de développement intégré (IDE) Visual Studio, vous pouvez faire en sorte qu'il crée des procédures de propriétés Get et Set vides. Tapez Property NomPropriété As TypeDonnées (où NomPropriété est le nom de la propriété et TypeDonnées est un type de données spécifique, tel que Integer). Les procédure de propriétés apparaissent dans l'Éditeur de code.

   L'exemple ci-dessous déclare une propriété dans une classe :

   Class ThisClass
       Private m_PropVal As String
       Public Property One() As String
           Get
               ' Return the value stored in the local variable.
               Return m_PropVal
           End Get
           Set(ByVal Value As String)
               ' Store the value in a local variable.
               m_PropVal = Value
           End Set
       End Property
   End Class
   

   Lorsque vous créez une instance de ThisClass et définissez la valeur de la propriété One, la procédure de propriété Set est appelée et la valeur est passée dans le paramètre Value, qui est stocké dans une variable locale appelée m_PropVal. Quand la valeur de cette propriété est extraite, la procédure de propriété Get est appelée à la manière d'une fonction et retourne la valeur stockée dans la variable locale m_PropVal.

Voir aussi

Tâches

Comment : ajouter des événements à une classe

Concepts

Propriétés et procédures de propriété

Référence

Property, instruction

Public (Visual Basic)

Shared (Visual Basic)