c# - How do I reference method parameters in a method summary when writing xml documentation? -


suppose have method follows:

    /// <summary>     /// here want reference parameter <see cref="personid"/>.     /// </summary>     /// <param name="personid">     /// person id.     /// </param>     /// <returns>     /// <see cref="person"/>.     /// </returns>     public person getperson(int personid)     {      } 

when publish xml documentation using sandcastle, cref:

<see cref="personid"/> 

gets converted [!:personid].

the warning in sandcastle is:

'unknown reference link target'

any advice? thanks.

use <paramref>

<paramref name="personid"/> 

Comments

Popular posts from this blog

javascript - three.js lot of meshes optimization -

smartface.io - Proper way to change color scheme for whole application -

Email notification in google apps script -