c++-cli - Xml 注释 cref 到未知符号

Question

试图通过我的项目并扩展文档，并有以下情况：

//TestClass.h
namespace Test {
    public enum class TypeOne {

        /// <summary>
        /// Description <see cref="Test::TypeTwo">TypeTwo</see>
        /// </summary>
        AAA
    };
    public enum class TypeTwo {
        BBB
    };
}

cref 产生以下错误：

警告 C4638：应用于“Test.TypeOne.AAA”的 XML 文档注释：引用未知符号“Test::TypeTwo”。

有没有办法让 xml 文档识别 TypeTwo？我只是将 TypeTwo 放在 TypeOne 之上，但 TypeTwo 也作为 TypeOne 的 cref，所以我会回到同样的情况。

我只是愚蠢吗？

Answer 1

您可能需要像在 C++ 中经常处理这样的循环引用一样处理这种情况：在 TypeOne 之前转发声明 TypeTwo（但不要定义它）。

Answer 2

我认为无论源文件语言如何，XML 文档都可能使用 C# 的范围表示法（错误消息肯定会这样做），所以也许可以尝试Test.TypeTwo.