Je suis venu sur cette situation plusieurs fois auparavant. Je souhaite référencer un type dans mes commentaires XML, mais le type est contenu dans un assembly non référencé par mon projet.Lien vers un type non référencé par mon projet dans les commentaires XML?
En A.dll (références B.dll):
using B;
///<summary>Hai I'm SomeClass and I use <seealso cref="B.LoserClass"/> to do my work</summary>
public class SomeClass {/*...*/}
En B.dll (ne fait pas référence A.dll):
///<summary> I can't <seealso cref="A.SomeClass"/> in this summary </summary>
public class LoserClass {/*...*/}
Dans les commentaires pour LoserClass
je dois référence SomeClass
mais je ne peux pas en raison du fait que B.DLL ne fait pas référence A.DLL (référence circulaire).
Existe-t-il un moyen d'inclure les informations d'assemblage dans la documentation de code LoserClass
de cref, afin que A.SomeClass
puisse être résolu par le générateur de documentation XML?
(BTW, vous ne pouvez pas toujours résoudre ce problème en cours en mouvement car il peut causer des dépendances circulaires dans d'autres endroits)
Je ne veux pas entrer dans les détails à ce sujet, mais la raison pour laquelle ils sont dans cette configuration est pas parce qu'ils ne connaissent pas , c'est parce qu'ils doivent être pour éviter les références circulaires. Bien qu'ils n'interagissent pas directement les uns avec les autres, je veux documenter leur interaction dans les commentaires. – Will
Je pense que cela se qualifie comme une odeur et je vais refactoriser cette idiotie en l'utilisant en combinant des assemblages qui n'auraient jamais dû être séparés en premier lieu. – Will