Sujet Précédent Sujet Suivant

Commentaires en POO

Résolu
cs_JLuc01 Messages postés 206 Date d'inscription samedi 17 janvier 2009 Statut Membre Dernière intervention 5 mars 2013 - 11 mai 2012 à 22:12
cs_JLuc01 Messages postés 206 Date d'inscription samedi 17 janvier 2009 Statut Membre Dernière intervention 5 mars 2013 - 12 mai 2012 à 16:11
Bonsoir,

J'aurais besoin de quelques precisions sur l'utilisation des commentaires en POO.

Par exemple dans le code suivant, quel genre d'information peut-on normalement mettre/utiliser pour <value>, <returns> et <remarks>, et quels avantages on en tire? 

''' <summary>
''' Customer for this Project
''' </summary>
''' <value></value>
''' <returns></returns>
''' <remarks></remarks>
<XmlElement("Customer")> _
Public Property pCustomer() As String
       Get
           Return _pCustomer
       End Get
       Set(ByVal value As String)
           _pCustomer = value
       End Set
End Property


Peut-etre une question bete, mais je la pose quand meme!

Pour <Summary>, c'est une information qu'on retrouve dans l'intellisense, mais pour les autres, cela me parait moins evident.

A+
JLuc01

2 réponses

Réponse 1 / 2
Utilisateur anonyme
12 mai 2012 à 02:53
Bonjour,

''' <value></value>

Pour une classe c'est la valeur par défaut de la propriété
Pour une une sub ou une function ordinaire c'est la valeur d'une variable, d'une constante ou d'un paramètre

''' <returns></returns>
Pour une fonction c'est le but du calcul ou le résultat attendu

''' <remarks></remarks>
Un commentaire général ou une information spéciale qui peut être utile pour le reviseur ou l'utilisateur. Par exemple une "passe spéciale ou le nom du programmeur ou la date de mise en service ou de la révision

et quels avantages on en tire?

Cela fait partie de la documentation. Regarde dans tes projets, tu devrais trouver un fichier xml qui porte le même nom que ton projet. Ouvre-le après avoir rempli une zone de commentaires.
3
Réponse 2 / 2
cs_JLuc01 Messages postés 206 Date d'inscription samedi 17 janvier 2009 Statut Membre Dernière intervention 5 mars 2013 1
12 mai 2012 à 16:11
Bonjour,

Et merci, cela m'eclaircit un peu plus sur ces commentaires en POO.
Mais le chemin d'apprentissage en POO est encore long.

A+
JLuc01
0

Discussions similaires

mettre en commentaire tout un bloc
Daydayer -
Daydayer -

3 réponses
passer en commentaire plusieurs lignes de code VBA rapidement
zncpo -
zncpo -

2 réponses
Question idiote : mise en commentaire de plusieures lignes
cs_oluha -
cs_oluha -

2 réponses
Modif de commentaire sous VBA excel
sobeit1 -
sobeit1 -

3 réponses
mettre en commentaire une fonction
cs_a_zouggari -
Nicko11 -

6 réponses
Rejoignez-nous