C # XML Belgeleri Web Sitesi Bağlantısı

XML belgelerine bir web sitesine bağlantı eklemek mümkün müdür? Örneğin, yöntemim şu şekilde özetlendi:

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

ve yazdığımda

SomeMathThing(

IntelliSense'in dışarıdaki bir web sitesine bağlanmak için "BURAYA" tıklatma seçeneğiyle özeti göstermesini istiyorum. Mümkün mü? Nasıl yapılır?

Deneyin:

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

Hype trende biraz geç, ama işte Visual Studio 2015 için bulduğum şey.

Benim örneğim şöyle:

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

Sonuçlar:

1. İpucu:
   • ! İle cref-url gösterir, ancak "this" gizler
   • Ahref-url'yi gizler, ancak metni gösterir
   • Seehref URL'sini ve metnini gizler

2. Nesne Tarayıcısı:
   • ! İle cref-url gösterir, ancak "this" i gizler (tıklanabilir değil)
   • Ahref-url'yi gizler, ancak metni gösterir (tıklanabilir değil)
   • Seehref URL'sini ve metnini gizler (tıklanamaz)

3. ReSharper (CTRL + ÜST KRKT + F1, ReSharper Komutu. ReSharper_QuickDoc)
   • ! İle cref-url'yi gizler, ancak "this" i (tıklanabilir değil) gösterir
   • Şimdi ahref-url'ü yorumlamaktadır (2016 ve daha yeni sürümler)
   • Seehref URL'sini ve metnini gizler (tıklanamaz)

Sonuç: Heiner'ın belirttiği gibi en iyisi,

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

Güncelle Thomas Hagström'ün işaret ettiği gibi, Resharper artık tıklanabilir a-href URL'lerini destekliyor. Ekran görüntüsü buna göre güncellendi.

Standart HTML sözdizimini kullanabilirsiniz:

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

Metin Visual Studio'da görüntülenecektir.

Innovasys Document gibi araçların oluşturulmuş Xml belgelerinde dokunulmadan geçirilmesi için bir cref içine bir!: Öneki ekleyebilirsiniz. X ve Sandcastle kullanacak. Örneğin

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

Visual Studio intellisense bunu intellisense için bir bağlantı olarak göstermez - bir araç ipucu olduğu için fazla bir nokta olmaz, bu yüzden yine de tıklayamazsınız.

Bir etiket kullanın. Mesela ben bu çözümü kullanılan Projemdeki

Sonuç burada

Benim xml kodum:

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

Veya "see" etiketini kullanın. Sonuç "a" etiketiyle aynı

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