ลิงค์เว็บไซต์เอกสาร 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 ด้วย!: แต่ซ่อน "this"
   • ซ่อน ahref-url แต่แสดงข้อความ
   • ซ่อน seehref url และข้อความ

2. เบราว์เซอร์วัตถุ:
   • แสดง cref-url ด้วย!: แต่ซ่อน "this" (ไม่สามารถคลิกได้)
   • ซ่อน ahref-url แต่แสดงข้อความ (ไม่สามารถคลิกได้)
   • ซ่อน seehref url และข้อความ (ไม่สามารถคลิกได้)

3. ReSharper (CTRL + SHIFT + F1, คำสั่ง ReSharper.ReSharper_QuickDoc)
   • ซ่อน cref-url ด้วย!: แต่แสดง "this" (ไม่สามารถคลิกได้)
   • ตอนนี้ตีความ ahref-url (เวอร์ชั่นตั้งแต่ 2016 และใหม่กว่า) หรือไม่
   • ซ่อน seehref url และข้อความ (ไม่สามารถคลิกได้)

บทสรุป: หนึ่งที่ดีที่สุดในขณะที่ไฮเนอร์ชี้ให้เห็นจะเป็น

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

อัปเดต ตามที่ Thomas Hagströmชี้ให้เห็นตอนนี้ Resharper รองรับ URL a-href ที่คลิกได้ อัปเดตภาพหน้าจอตามนั้น

คุณสามารถใช้ไวยากรณ์ HTML มาตรฐาน:

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

ข้อความจะปรากฏใน Visual Studio

คุณสามารถรวมคำนำหน้า!: ใน cref เพื่อให้ผ่านไม่ถูกแตะต้องในเอกสาร XML ที่สร้างขึ้นเพื่อให้เครื่องมือเช่นเอกสาร Innovasys! 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>