Come faccio a fare riferimento ai parametri del metodo in un riepilogo del metodo quando si scrive la documentazione xml?

Question

Supponiamo che io sono un metodo come segue:

/// <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) 
    { 

    } 

Quando pubblico la mia documentazione XML utilizzando castello di sabbia, il cref:

<see cref="personId"/> 

viene convertito in [:! PersonId].

L'avvertimento in Sandcastle è:

'destinazione del collegamento di riferimento Unknown'

Qualche consiglio? Grazie.

Answer 1

Usa <paramref>

<paramref name="personId"/>