Discussion :

[Lorenzo77]

coucou,

j'ai quelques petites questions sur les commentaires ...


1-dans le tuto "Bien commenter et documenter son code en C#" de ce site, il est indiqué a la fin que l'on peut utiliser NDOC pour transformer le fichier de documentation XML en un fichier HTML ou autre ... le problème c'est que ce NDOC plante lamentablement sur mon PC.
quelqu'un connait un autre prog stable ?


2-je ne sais pas comment gérer les références ambigüe quand j'ai des méthodes surchargées ...
l'erreur :

Référence ambiguë dans l'attribut cref*: 'St.abreger'. 'mesClasses.utile.St.abreger(object, char[], mesClasses.utile.Position)' pris par défaut, mais peut correspondre également à d'autres surcharges telles que 'mesClasses.utile.St.abreger(object, string)'. C:\Documents and Settings\lolo\Mes documents\Visual Studio 2008\Projects\_persoTest\mesClasses\utile\St.cs 1651

le commentaire qui provoque l'erreur :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
    /// <summary>
    /// Spécifie les différentes position pour <see cref="St.abreger"/> ou <see cref="St.completer"/>
    /// </summary>

comment indiquer au générateur de doc que je veux une surcharge précise ou n'importe lesquelles ?


merci

[tomlev]

Je crois qu'il faut mettre entre parenthèses les types des paramètres, pour indiquer de quelle surcharge il s'agit
Regarde la MSDN à ce sujet pour plus d'infos

[Lorenzo77]

merci, encore une bonne réponse