Création et configuration de membres de type (Concepteur de classes)
Vous pouvez ajouter des membres de type et les configurer à l'aide de la fenêtre Détails de classe.
Chaque type à même d'être représenté sur un diagramme de classes peut contenir des types de membres spécifiques.Le tableau suivant décrit les membres que les types peuvent contenir :
Type |
Membres qu'il peut contenir |
|---|---|
Classe |
méthode, propriété (pour C# et Visual Basic), champ, événement (pour C# et Visual Basic), constructeur (méthode), destructeur (méthode), constante |
Enum |
membre |
Interface |
méthode, propriété, événement (pour C# et Visual Basic) |
Classe abstraite |
méthode, propriété (pour C# et Visual Basic), champ, événement (pour C# et Visual Basic), constructeur (méthode), destructeur (méthode), constante |
Structure (Struct en C#) |
méthode, propriété (pour C# et Visual Basic) champ, événement (pour C# et Visual Basic), constructeur (méthode), constante |
Délégué |
Paramètre |
Module (VB uniquement) |
méthode, propriété, champ, événement, constructeur, constante |
[!REMARQUE]
Les propriétés implémentées automatiquement (C# uniquement) rendent la déclaration de propriété plus concise lorsque aucune logique supplémentaire n'est requise dans les accesseurs get et set de la propriété.Pour afficher la signature complète, dans le menu Diagramme de classes, sélectionnez Modifier le format des membres, puis cliquez sur Afficher la signature complète.Pour plus d'informations sur les propriétés implémentées automatiquement, consultez Propriétés implémentées automatiquement (Guide de programmation C#).
Tâches courantes
Tâche |
Contenu de support |
|---|---|
Pour commencer : Avant de créer et configurer des membres de type, vous devez ouvrir la fenêtre Détails de classe. |
|
Créer et modifier des membres de type : Vous pouvez créer de nouveaux membres, modifier les membres, et ajouter des paramètres à une méthode à l'aide de la fenêtre Détails de classe. |
créer des membres
Vous pouvez créer un membre à l'aide de l'un des outils suivants :
Concepteur de classes
Barre d'outils de la fenêtre Détails de classe
Fenêtre Détails de classe
[!REMARQUE]
Vous pouvez aussi créer des constructeurs et des destructeurs à l'aide des procédures de cette section.N'oubliez pas que les constructeurs et les destructeurs constituent des genres particuliers de méthodes et que, comme tels, ils apparaissent dans le compartiment Méthodes des formes du diagramme de classes et dans la section Méthodes de la grille de fenêtre Détails de classe.
[!REMARQUE]
La seule entité que vous pouvez ajouter à un délégué est un paramètre.Notez que la procédure intitulée « Pour créer un membre à l'aide de la barre d'outils de la fenêtre Détails de classe » n'est pas valide pour cette action.
Pour créer un membre à l'aide du Concepteur de classes
Cliquez avec le bouton droit sur le type auquel vous souhaitez ajouter un membre, pointez sur Ajouter, puis cliquez sur Ajouter <membre>.
Une nouvelle signature de membre est créée et ajoutée au type.Le nom attribué par défaut peut être modifié dans le Concepteur de classes, la fenêtre Détails de classe ou la fenêtre Propriétés.
Vous pouvez, à titre facultatif, spécifier d'autres détails sur le membre, comme son type.
Pour créer un membre à l'aide de la barre d'outils de la fenêtre Détails de classe
Sur la surface du diagramme, sélectionnez le type auquel vous souhaitez ajouter un membre.
Le type obtient le focus et son contenu est affiché dans la fenêtre Détails de classe.
Dans la barre d'outils de la fenêtre Détails de classe, cliquez sur l'icône supérieure et sélectionnez Nouveau < membre > dans la liste déroulante.
Le curseur se déplace sur le champ Nom d'une ligne pour le genre de membre que vous souhaitez ajouter.Par exemple, si vous avez cliqué sur Nouvelle propriété, le curseur se déplace sur une nouvelle ligne dans la section Propriétés de la fenêtre Détails de classe.
Tapez le nom du membre que vous voulez créer et appuyez sur Entrée (ou déplacez le focus en appuyant sur la touche TAB).
Une nouvelle signature de membre est créée et ajoutée au type.Le membre existe maintenant dans le code ; il est affiché dans le Concepteur de classes, la fenêtre Détails de classe et la fenêtre Propriétés.
Vous pouvez, à titre facultatif, spécifier d'autres détails sur le membre, comme son type.
Pour créer un membre à l'aide de la fenêtre Détails de classe
Sur la surface du diagramme, sélectionnez le type auquel vous souhaitez ajouter un membre.
Le type obtient le focus et son contenu est affiché dans la fenêtre Détails de classe.
Dans la fenêtre Détails de classe, dans la section contenant le genre de membre que vous souhaitez ajouter, cliquez sur <ajouter un membre>.Par exemple, si vous souhaitez ajouter un champ, cliquez sur <ajouter un champ>.
Tapez le nom du membre que vous voulez créer et appuyez sur Entrée.
Une nouvelle signature de membre est créée et ajoutée au type.Le membre existe maintenant dans le code ; il est affiché dans le Concepteur de classes, la fenêtre Détails de classe et la fenêtre Propriétés.
Vous pouvez, à titre facultatif, spécifier d'autres détails sur le membre, comme son type.
Remarque : vous pouvez aussi utiliser des raccourcis clavier pour créer les membres.Pour plus d'informations, consultez Raccourcis clavier et souris dans le diagramme de classes et dans la fenêtre Détails de classe(Concepteur de classes).
modifier des membres de type
Le Concepteur de classes permet de modifier les membres de types affichés sur le diagramme.Vous pouvez modifier les membres de n'importe quel type affiché sur un diagramme de classes, à condition que ce type ne soit pas en lecture seule.(Consultez Display of Read-Only Information.) Pour modifier des membres de type, utilisez la modification sur place sur l'aire de conception, la fenêtre Propriétés et la fenêtre Détails de classe.
Tous les membres affichés dans la fenêtre Détails de classe représentent les membres des types figurant dans le diagramme de classes.Il existe quatre types de membres : les méthodes, les propriétés, les champs et les événements.
Toutes les lignes membres apparaissent sous les en-têtes qui regroupent les membres par genre.Par exemple, toutes les propriétés apparaissent sous l'en-tête Propriétés, lequel peut être réduit ou développé, comme tout nœud de la grille.
Chaque ligne membre affiche les éléments suivants :
Icône Membre
Chaque genre de membre est représenté par sa propre icône.Pointez la souris sur l'icône de membre pour afficher la signature du membre.Cliquez sur l'icône de membre ou sur l'espace blanc à gauche de l'icône de membre pour sélectionner la ligne.
Nom du membre
La colonne Nom d'une ligne membre affiche le nom du membre.Ce nom est également affiché dans la propriété Name de la fenêtre Propriétés.Utilisez cette cellule pour modifier le nom d'un membre qui dispose d'autorisations en lecture-écriture.
Si la colonne de nom est trop étroite pour afficher le nom entier, le fait de pointer la souris sur le nom de membre permet d'affiche l'intégralité du nom.
Type de membre
La cellule Typede membre utilise la technologie IntelliSense, qui vous permet de faire une sélection au sein de la liste de tous les types disponibles du projet en cours ou des projets référencés.
Modificateur de membre
Modifiez le modificateur de visibilité d'un membre en Public (public), Private (private), Friend (internal) Protected (protected), ProtectedFriend (protectedinternal) ou Default.
<ajouter un membre>
La dernière ligne de la fenêtre Détails de classe contient le texte <ajouter un membre> dans la cellule Nom.Si vous cliquez sur cette cellule, vous pouvez créer un membre.Pour plus d'informations, consultez Creating Members.
Propriétés du membre dans la fenêtre Propriétés
La fenêtre Détails de classe affiche un sous-ensemble des propriétés du membre affichées dans la fenêtre Propriétés.La modification d'une propriété dans un emplacement met à jour la valeur de la propriété de façon globale.Cela inclut l'affichage de sa valeur dans l'autre emplacement.
Résumé
La cellule Résumé contient un résumé des informations sur le membre.Cliquez sur les points de suspension dans la cellule Résumé pour afficher ou modifier les informations sur le Résumé, le Type de retour et les Notes du membre.
Masquer
Lorsque la case à cocher Masquer est activée, le membre n'est pas affiché dans le type.
Pour modifier un membre de type
À l'aide du Concepteur de classes, sélectionnez un type.
Si la fenêtre Détails de classe n'est pas affichée, cliquez sur le bouton Fenêtre Détails de classe sur la barre d'outils du Concepteur de classes.
Modifiez les valeurs des champs de la grille de la fenêtre Détails de classe.Après chaque modification, appuyez sur ENTRÉE ou éloignez le focus du champ modifié, par exemple en appuyant sur la touche TAB.Les modifications sont immédiatement répercutées dans le code.
[!REMARQUE]
Si vous souhaitez modifier uniquement le nom d'un membre, vous pouvez le faire à l'aide de la modification sur place.
Ajout de paramètres à des méthodes
Ajoutez des paramètres aux méthodes à l'aide de la fenêtre Détails de classe.Les paramètres peuvent être configurés pour être obligatoires ou optionnels.La valeur de la propriété Valeur par défaut facultative d'un paramètre demande au concepteur de générer le code en tant que paramètre optionnel.
Les lignes de paramètres contiennent les éléments suivants :
Nom
La colonne Nom d'une ligne de paramètres affiche le nom du paramètre.Ce nom est également affiché dans la propriété Name de la fenêtre Propriétés.Vous pouvez utiliser cette cellule pour modifier le nom d'un paramètre ayant les autorisations en lecture-écriture.
Le fait de pointer sur le nom du paramètre affiche celui-ci si la colonne Nom est trop étroite pour afficher la totalité du nom.
Type
La cellule Type de paramètre utilise la technologie Intellisense, qui permet de choisir au sein de la liste de tous les types disponibles du projet en cours ou des projets référencés.
Modificateur
La cellule Modificateur d'une ligne de paramètres accepte le nouveau modificateur du paramètre et l'affiche.Pour entrer un nouveau modificateur de paramètre, utilisez la zone de liste déroulante pour effectuer la sélection dans Aucun, ref, out, ou params en C# et ByVal, ByRef ou ParamArray en Visual Basic.
Résumé
La cellule Résumé d'une ligne de paramètre permet d'entrer des commentaires de code qui s'affichent dans IntelliSense lors de la saisie du paramètre dans l'éditeur de code.
<ajouter un paramètre>
La dernière ligne de paramètres d'un membre contient le texte <ajouter un paramètre> dans la cellule Nom.Cliquez sur cette cellule pour créer un nouveau paramètre.Pour plus d'informations, consultez To add a parameter to a method.
Propriétés des paramètres dans la fenêtre Propriétés
La fenêtre Propriétés affiche les mêmes propriétés de paramètre que celles affichées dans la fenêtre Détails de classe : Nom, Type, Modificateur, Résumé, ainsi que la propriété Valeur par défaut facultative.La modification d'une propriété dans un emplacement met à jour la valeur de la propriété de manière globale, y compris l'affichage de sa valeur dans l'autre emplacement.
[!REMARQUE]
Pour ajouter un paramètre à un délégué, consultez Creating Members.
[!REMARQUE]
Bien qu'un destructeur soit une méthode, il ne peut pas avoir de paramètres.
Pour ajouter un paramètre à une méthode
Sur la surface du diagramme, cliquez sur le type qui contient la méthode à laquelle vous souhaitez ajouter un paramètre.
Le type obtient le focus et son contenu est affiché dans la fenêtre Détails de classe.
Dans la fenêtre Détails de classe, développez la ligne de la méthode à laquelle vous souhaitez ajouter un paramètre.
Une ligne de paramètres mise en retrait s'affiche ; elle contient uniquement une paire de parenthèses et les mots <ajouter un paramètre>.
Cliquez sur <ajouter un paramètre>, tapez le nom du nouveau paramètre, puis appuyez sur Entrée.
Le nouveau paramètre est ajouté à la méthode et à son code.Il apparaît dans la fenêtre Détails de classe et dans la fenêtre Propriétés.
Vous pouvez, à titre facultatif, spécifier d'autres détails sur le paramètre, comme son type.
Pour ajouter un paramètre optionnel à une méthode
Sur la surface du diagramme, cliquez sur le type qui contient la méthode à laquelle vous souhaitez ajouter un paramètre optionnel.
Le type obtient le focus et son contenu est affiché dans la fenêtre Détails de classe.
Dans la fenêtre Détails de classe, développez la ligne de la méthode à laquelle vous souhaitez ajouter un paramètre optionnel.
Une ligne de paramètres mise en retrait s'affiche ; elle contient uniquement une paire de parenthèses et les mots <ajouter un paramètre>.
Cliquez sur <ajouter un paramètre>, tapez le nom du nouveau paramètre, puis appuyez sur Entrée.
Le nouveau paramètre est ajouté à la méthode et à son code.Il apparaît dans la fenêtre Détails de classe et dans la fenêtre Propriétés.
Dans la fenêtre Propriétés, tapez une valeur pour la propriété Valeur par défaut facultative.La définition de la propriété Valeur par défaut facultative d'un paramètre rend ce paramètre optionnel.
[!REMARQUE]
Les paramètres optionnels doivent être les derniers paramètres dans la liste de paramètres.
ouvrir la fenêtre Détails de classe
Par défaut, la fenêtre Détails de classe s'affiche automatiquement quand vous ouvrez un nouveau diagramme de classes (consultez Comment : ajouter des diagrammes de classes aux projets (Concepteur de classes)).Vous pouvez aussi ouvrir explicitement la fenêtre Détails de classe, comme indiqué ci-après.
Pour ouvrir la fenêtre Détails de classe
Cliquez avec le bouton droit sur la surface d'un diagramme de classes pour afficher un menu contextuel.
Dans le menu contextuel, cliquez sur Fenêtre Détails de classe.
- ou -
- Pointez sur Autres fenêtres dans le menu Affichage, puis cliquez sur Détails de classe.
La classe détaille les notes d'utilisation
Notez les conseils suivants pour utiliser la fenêtre Détails de classe.
Cellules modifiables et cellules non modifiables
Toutes les cellules de la fenêtre Détails de classe sont modifiables, à quelques exceptions près :
Le type est en lecture seule, quand, par exemple, il réside dans un assembly référencé (consultez Display of Read-Only Information.) Lorsque vous sélectionnez la forme dans le Concepteur de classes, la fenêtre Détails de classe affiche ses détails en lecture seule.
Pour les indexeurs, le nom est en lecture seule et le reste (type, modificateur, résumé) est modifiable.
Tous les génériques ont des paramètres en lecture seule dans la fenêtre Détails de classe.Pour modifier un paramètre générique, modifiez son code source.
Le nom du paramètre de type qui est défini sur un type générique est en lecture seule.
Lorsque le code d'un type est rompu (non analysable), la fenêtre Détails de classe affiche le contenu du type en lecture seule.
Fenêtre Détails de classe et code source
Vous pouvez consulter le code source en cliquant avec le bouton droit sur une forme de la fenêtre Détails de classe (ou du Concepteur de classes), puis en cliquant sur Afficher le code.Le fichier correspondant s'ouvre et le code source défile jusqu'à l'élément sélectionné.
La modification du code source est immédiatement répercutée dans l'affichage des informations de signature dans le Concepteur de classes ou dans la fenêtre Détails de classe.Si la fenêtre Détails de classe est fermée à ce moment-là, les nouvelles informations ne seront visibles qu'à la prochaine ouverture.
Lorsque le code d'un type est rompu (non analysable), la fenêtre Détails de classe affiche le contenu du type en lecture seule.
Utilisation du Presse-papiers dans la fenêtre Détails de classe
Vous pouvez copier ou couper des champs ou des lignes dans la fenêtre Détails de classe et les coller dans un autre type.Vous ne pouvez couper une ligne que si elle n'est pas en lecture seule.Lorsque vous collez la ligne, la fenêtre Détails de classe assigne un nouveau nom (dérivé du nom de la ligne copiée) afin d'éviter tout conflit.
affichage des informations en lecture seule
Le Concepteur de classes et la fenêtre Détails de classe peuvent afficher les types (et les membres de types) des éléments suivants :
projet contenant un diagramme de classes
projet référencé d'un projet contenant un diagramme de classes
assembly référencé d'un projet contenant un diagramme de classes
Dans les deux derniers cas, l'entité référencée (un type ou un membre) est en lecture seule dans le diagramme de classes qui la représente.
Tout ou partie (certains fichiers, par exemple) d'un projet peut être en lecture seule.Les cas les plus communs où un projet ou l'un de ses fichiers est en lecture seule se produisent quand le projet ou le fichier est sous contrôle du code source (et n'a pas été extrait), qu'il existe dans un assembly externe ou que le système d'exploitation considère les fichiers comme étant en lecture seule.
Contrôle du code source
Parce qu'un diagramme de classes est enregistré en tant que fichier dans un projet, vous devez extraire le projet pour sauvegarder toutes les modifications effectuées dans le Concepteur de classes ou dans la fenêtre Détails de classe.
Projets en lecture seule
Le projet peut être en lecture seule pour une autre raison que le contrôle du code source.La fermeture du projet affiche une boîte de dialogue qui demande si vous souhaitez remplacer le fichier projet, ignorer les modifications (aucun enregistrement) ou annuler l'opération de fermeture.Si vous faites le choix du remplacement, les fichiers projet sont remplacés et rendus accessibles en lecture-écriture.Le nouveau fichier du diagramme de classes est ajouté.
Types en lecture seule
Si vous essayez d'enregistrer un projet contenant un type dont le fichier de code source est en lecture seule, la boîte de dialogue Enregistrement d'un fichier accessible en lecture seule qui apparaît vous donne le choix entre enregistrer le fichier sous un nouveau nom (ou dans un nouvel emplacement) ou remplacer le fichier en lecture seule.Si vous remplacez le fichier, la nouvelle copie n'est plus en lecture seule.
Si un fichier de code contient une erreur de syntaxe, les formes dédiées à l'affichage du code de ce fichier restent en lecture seule tant que l'erreur de syntaxe n'est pas résolue.Les formes affichent alors le texte en rouge et une icône de couleur rouge, accompagnée d'une info-bulle dont le texte est le suivant : « Le fichier de code source contient une erreur d'analyse. »
Un type référencé (comme un type .NET Framework), qui existe sous un autre nœud de projet ou sous un nœud d'assembly référencé, est signalé sur l'aire de conception du Concepteur de classes comme étant en lecture seule.Un type local, qui existe dans le projet que vous a ouvert, est en lecture-écriture, et sa forme sur l'aire de conception du Concepteur de classes est indiquée comme telle.
Les indexeurs sont en lecture-écriture dans le code et dans la fenêtre Détails de classe, mais le nom d'indexeur est en lecture seule.
Vous ne pouvez pas modifier de méthodes partielles à l'aide du Concepteur de classes ou de la fenêtre Détails de classe ; pour réaliser cette opération, vous devez utiliser l'éditeur de code.
Vous ne pouvez pas modifier de code C++ natif à l'aide du Concepteur de classes ou de la fenêtre Détails de Classe ; pour réaliser cette opération, vous devez utiliser l'éditeur de code.
Rubriques connexes
Titre |
Description |
|---|---|
Vous pouvez consulter vos types, membres, et relations existants dans un diagramme de classes. |
|
Refactorisation des classes et des types (Concepteur de classes) |
En utilisant la refactorisation, vous pouvez renommer facilement le type et membres de type.vous pouvez également déplacer des membres entre les classes, couper une classe en classes partielles, et implémenter des interfaces. |