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)

Foi útil?

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

Licenciado em: CC-BY-SA com atribuição
Não afiliado a StackOverflow
scroll top