Посилання на веб-сайт документації C # XML

Чи можливо включити посилання на веб-сайт у документацію XML? Наприклад, мій метод узагальнений як

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

і коли я набираю

SomeMathThing(

Я хочу, щоб IntelliSense показав резюме з можливістю натиснути "ТУТ" для посилання на зовнішній веб-сайт. Чи можливо це? Як би це було зроблено?

Спробуйте:

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

Трохи запізнюємось на потяг, але ось що я дізнався для Visual Studio 2015.

Мій зразок виглядає так:

    /// <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);
    }

Результати:

1. Підказка:
   • Показує cref-url за допомогою !:, але приховує "це"
   • Сховає ahref-url, але показує текст
   • Приховує URL-адресу та текст Seehref

2. Оглядач об’єктів:
   • Показує cref-url за допомогою !:, але приховує "це" (не можна натискати)
   • Сховає ahref-url, але показує текст (не можна натискати)
   • Приховує URL-адресу та текст Seehref (не можна натискати)

3. ReSharper (CTRL + SHIFT + F1, Command ReSharper.ReSharper_QuickDoc)
   • Сховає cref-url з !:, але показує "це" (не можна натискати)
   • Чи інтерпретує зараз ahref-url (версія від 2016 року та новіші)
   • Приховує URL-адресу та текст Seehref (не можна натискати)

Висновок: Найкращим, як зазначив Гейнер, був би

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

Оновлення Як зазначив Томас Хагстрьом, Resharper тепер підтримує URL-адреси a-href, які можна натискати. Оновлено відповідний знімок екрана.

Ви можете використовувати стандартний синтаксис HTML:

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

Текст буде показаний у Visual Studio.

Ви можете включити префікс!: У Cref, щоб він пройшов недоторканим у створеній Xml документації, щоб такі інструменти, як Innovasys Document! X і Sandcastle будуть використовувати його. напр

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

Visual Studio intellisense не відображатиме це як посилання на intellisense - це не буде великою точністю, оскільки це підказка, тому ви не можете натиснути його все одно.

Використовуйте тег. Наприклад, я використав це рішення у своєму проекті

Результат тут

Мій xml код:

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

Або скористайтеся тегом "див". Результат - це тег "a"

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