Comment : utiliser les modificateurs et les propriétés GenerateMember

Mise à jour : novembre 2007

Lorsque vous placez un composant sur un Windows Form, deux propriétés sont fournies par l'environnement de design : GenerateMember et Modifiers. La propriété GenerateMember spécifie à quel moment le Concepteur Windows Forms génère une variable membre pour un composant. La propriété Modifiers est le modificateur d'accès assigné à cette variable membre. Si la valeur de la propriété GenerateMember est false, la valeur de la propriété Modifiers n'a aucun effet.

Remarque :
En fonction de vos paramètres actifs ou de l'édition utilisée, les boîtes de dialogue et les commandes de menu qui s'affichent peuvent être différentes de celles qui sont décrites dans l'aide. Pour modifier vos paramètres, choisissez Importation et exportation de paramètres dans le menu Outils. Pour plus d'informations, consultez Paramètres Visual Studio.

Pour spécifier si un composant est un membre du formulaire

1. Dans le Concepteur Windows Forms, ouvrez votre formulaire.

2. Ouvrez la boîte à outils et, sur le formulaire, placez trois contrôles Button.

3. Définissez les propriétés GenerateMember et Modifiers pour chaque contrôle Button d'après le tableau suivant.

   Nom du bouton	Valeur de GenerateMember	Valeur de Modifiers
   button1	true	private
   button2	true	protected
   button3	false	Aucune modification

4. Générez la solution.

5. Dans l'Explorateur de solutions, cliquez sur le bouton Afficher tous les fichiers.

6. Ouvrez le nœud Form1, puis dans l'éditeur de code, ouvrez le fichier Form1.Designer.vb ou Form1.Designer.cs. Ce fichier contient le code émis par le Concepteur Windows Forms.

7. Recherchez les déclarations pour les trois boutons. L'exemple de code suivant montre les différences spécifiées par les propriétés GenerateMember et Modifiers.

   Private Sub InitializeComponent()
   
       ' button3 is declared in a local scope, because 
       ' its GenerateMember property is false.
       Dim button3 As System.Windows.Forms.Button
       Me.button1 = New System.Windows.Forms.Button()
       Me.button2 = New System.Windows.Forms.Button()
       button3 = New System.Windows.Forms.Button()
   

   private void InitializeComponent()
   {   
       // button3 is declared in a local scope, because 
       // its GenerateMember property is false.
       System.Windows.Forms.Button button3;
       this.button1 = new System.Windows.Forms.Button();
       this.button2 = new System.Windows.Forms.Button();
       button3 = new System.Windows.Forms.Button();
   

    ' The Modifiers property for button1 is "Private".
    Private button1 As Button
   
    ' The Modifiers property for button2 is "Protected".
    Protected button2 As Button
   
   ' button3 is not a member, because 
   ' its GenerateMember property is false.
   

   // The Modifiers property for button1 is "private".
   private Button button1;
   
   // The Modifiers property for button2 is "protected".
   protected Button button2;
   
   // button3 is not a member, because 
   // its GenerateMember property is false.
   

Remarque :
Par défaut, le Concepteur Windows Forms assigne le modificateur private (Friend en Visual Basic) aux contrôles conteneur comme Panel. Si votre Form ou UserControl de base a un contrôle conteneur, il n'acceptera pas de nouveaux enfants dans les formulaires et contrôles hérités. La solution consiste à changer le modificateur du contrôle conteneur de base en protected ou public.

Voir aussi

Tâches

Procédure pas à pas : démonstration de l'héritage visuel

Comment : hériter des Windows Forms

Référence

Button

Autres ressources

Héritage visuel des Windows Forms