当我编写XML文档时，如何在方法概述中引用方法参数？

Question

假设我有一个如下的方法：

    /// <summary>
    /// Here I want to reference the parameter <see cref="personId"/>.
    /// </summary>
    /// <param name="personId">
    /// The person id.
    /// </param>
    /// <returns>
    /// The <see cref="Person"/>.
    /// </returns>
    public Person GetPerson(int personId)
    {
        
    }

当我使用 Sandcastle 发布我的 XML 文档时，cref:

<see cref="personId"/>

被转换为[!:personId]。

sandcastle中的警告是：

未知引用链接目标

有什么建议吗？

- user2078938

---

未来使用时，以下是XML文档标记列表。 - Matthew Watson

Answer 1

使用<paramref>

<paramref name="personId"/>

- dcastro