Link para um tipo não referenciado pelo meu projeto nos comentários XML?
-
20-08-2019 - |
Pergunta
Eu já encontrei essa situação algumas vezes antes. Desejo referência a um tipo nos meus comentários XML, mas o tipo está contido em uma montagem não referenciada pelo meu projeto.
Em A.DLL (Referências B.Dll):
using B;
///<summary>Hai I'm SomeClass and I use <seealso cref="B.LoserClass"/> to do my work</summary>
public class SomeClass {/*...*/}
Em B.DLL (não faz referência a A.DLL):
///<summary> I can't <seealso cref="A.SomeClass"/> in this summary </summary>
public class LoserClass {/*...*/}
Nos comentários para LoserClass
Eu preciso fazer referência SomeClass
Mas não posso devido ao fato de que o B.DLL não faz referência a A.DLL (referência circular).
Existe alguma maneira de incluir as informações da montagem no cref dentro LoserClass
'Código de documentação, para que A.SomeClass
Pode ser resolvido pelo gerador de documentação XML?
(btw, você nem sempre pode resolver isso movendo as classes, pois pode causar dependências circulares em outros lugares)
Solução
Não sei uma maneira de fazer isso e estou convencido de que não existe. A questão é: por que motivo você deseja que você indique nos comentários do componente B a A? B não sabe nada de A, certo? A usa B, por isso faz sentido para mim, que os comentários refletem essa dependência também. Mas o contrário não faz sentido para mim.
Essa é apenas minha humilde opinião,
Prensen