How to force a Documentation <see /> element to reference the type instead of the property with the same name?

StackOverflow https://stackoverflow.com/questions/17338927

  •  01-06-2022
  •  | 
  •  

Pregunta

It is relatively common practice for property names to default to the type name when the type name is significant enough;

public class User { }
public class UserSession
{
    /// <summary>
    /// Creates a <see cref="UserSession" /> instance
    /// with the given <see cref="User" />
    /// </summary>
    public UserSession(User user)
    {
        User = user;
    }

    public User User { get; private set; }
}

My problem is that the <see cref="User" /> element in the XML documentation refers to the UserSession.User property. What should I write in order to reference the User type instead?

¿Fue útil?

Solución

Use the full name of the type, including the namespace.

Otros consejos

Write the full name of User as shown in <see> (C# Programming Guide) with System.Console.WriteLine(String):

<see cref="YourNamespace.User"/>
Licenciado bajo: CC-BY-SA con atribución
No afiliado a StackOverflow
scroll top