Lien vers le site Web de documentation XML C #

Est-il possible d'inclure un lien vers un site Web dans la documentation XML? Par exemple, ma méthode est résumée comme

///<Summary>
/// This is a math function I found HERE.
///</Summary>
public void SomeMathThing(Double[] doubleArray)
{
   ...
}

et quand je tape

SomeMathThing(

Je veux qu'IntelliSense affiche le résumé avec l'option de cliquer sur "ICI" pour créer un lien vers un site Web extérieur. Est-ce possible? Comment cela se ferait-il?

Essayer:

///<Summary>
/// This is a math function I found <see href="http://stackoverflow.com">HERE</see>
///</Summary>

Un peu en retard dans le train hype, mais voici ce que j'ai découvert pour Visual Studio 2015.

Mon échantillon ressemble à ceci:

    /// <summary>
    ///     Retrieves information about the specified window. 
    ///     The function also retrieves the value at a specified offset into the extra window memory.
    ///     From <see cref="!:https://msdn.microsoft.com/en-us/library/windows/desktop/ms633585(v=vs.85).aspx">this</see> MSDN-Link.
    ///     AHref <a href="http://stackoverflow.com">here</a>.
    ///     see-href <see href="http://stackoverflow.com">here</see>.
    /// </summary>
    /// <param name="hwnd"></param>
    /// <param name="index"></param>
    /// <returns>
    ///     Testlink in return: <a href="http://stackoverflow.com">here</a>
    /// </returns>
    public static IntPtr GetWindowLongPtr(IntPtr hwnd, int index)
    {
        return IntPtr.Size == 4 ? GetWindowLongPtr32(hwnd, index) : GetWindowLongPtr64(hwnd, index);
    }

Les résultats sont:

1. Info-bulle:
   • Affiche cref-url avec!:, Mais masque "this"
   • Masque ahref-url mais affiche le texte
   • Masque l'URL et le texte de seehref

2. Navigateur d'objets:
   • Affiche cref-url avec!:, Mais masque "this" (non cliquable)
   • Masque ahref-url mais affiche le texte (non cliquable)
   • Masque l'URL et le texte de seehref (non cliquable)

3. ReSharper (CTRL + SHIFT + F1, commande ReSharper.ReSharper_QuickDoc)
   • Masque l'URL de la référence avec!:, Mais affiche "this" (non cliquable)
   • Interprète maintenant ahref-url (version de 2016 et plus récente)
   • Masque l'URL et le texte de seehref (non cliquable)

Conclusion: le meilleur, comme l'a souligné Heiner, serait

See <a href="link">this link</a> for more information.

Mise à jour Comme l'a souligné Thomas Hagström, Resharper prend désormais en charge les URL cliquables a-href. Capture d'écran mise à jour en conséquence.

Vous pouvez utiliser la syntaxe HTML standard:

<a href="http://stackoverflow.com">here</a>

Le texte sera affiché dans Visual Studio.

Vous pouvez inclure un préfixe!: Dans un cref pour qu'il soit passé intact dans la documentation Xml générée afin que des outils tels que Innovasys Document! X et Sandcastle l'utiliseront. par exemple

/// <summary>
/// This is a math function I found <see cref="!:http://stackoverflow.com">HERE</see>
/// </summary>

Visual Studio intellisense ne l'affichera pas comme un lien pour intellisense - ne serait pas très utile car il s'agit d'une info-bulle, vous ne pouvez donc pas cliquer dessus de toute façon.

Utilisez une balise. Par exemple j'ai utilisé cette solution dans mon projet

Le résultat est ici

Mon code xml est:

/// <summary>
/// This is C# XML Documentation Website Link
/// <a href="/programming/6960426/c-sharp-xml-documentation-website-link">See more</a>
/// </summary>

Ou utilisez la balise "voir". Le résultat est le même de la balise "a"

/// <summary>
/// This is C# XML Documentation Website Link
/// <see href="/programming/6960426/c-sharp-xml-documentation-website-link">See more</see>
/// </summary>