¿Enlace a un tipo no referenciado por mi proyecto en comentarios XML?
-
20-08-2019 - |
Pregunta
Me he encontrado con esta situación varias veces antes. Deseo hacer referencia a un tipo en mis comentarios XML, pero el tipo está contenido en un ensamblado al que no hace referencia mi proyecto.
En A.Dll (referencias 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 (NO hace referencia a A.DLL):
///<summary> I can't <seealso cref="A.SomeClass"/> in this summary </summary>
public class LoserClass {/*...*/}
En los comentarios para LoserClass
necesito hacer referencia a SomeClass
pero no puedo debido al hecho de que B.DLL no hace referencia a A.DLL (referencia circular).
¿Hay alguna forma de incluir la información del ensamblaje en la cref dentro de la documentación del código A.SomeClass
', para que el generador de documentación XML pueda resolver <=>?
(por cierto, no siempre puede resolver esto moviendo clases, ya que puede causar dependencias circulares en otros lugares)
Solución
No sé cómo hacer esto y estoy convencido de que no existe. La pregunta es, ¿por qué razón quieres que te refieras en los comentarios del componente B a A? B no sabe nada de A, ¿verdad? A usa B, por lo que tiene sentido para mí, que los comentarios reflejen esta dependencia también. Pero al revés no tiene sentido para mí.
Esa es solo mi humilde opinión,
Prensen