Làm cách nào để bao gồm thẻ html trong bản tóm tắt C# để nó được xử lý dưới dạng văn bản (không được phân tích cú pháp dưới dạng XML)?

Question

Tôi đang viết một trình phân tích cú pháp HTML trong C# và muốn bao gồm các ví dụ về HTML mà nó xử lý trong các khối XML tóm tắt. Làm thế nào để ngăn chặn các ký tự < và> khỏi làm rối loạn tài liệu tự động của Visual Studio 2008?

dụ:

/// <summary> 
    /// Creates a FlowSegment based on an HTML code, i.e. <bold> 
    /// </summary> 
    /// <param name="code"></param> 
    /// <returns></returns> 
    public FlowSegment(string code) 
    { 

Đáng tiếc là ví dụ gây mũi công cụ để xây dựng này để hiển thị (một phần):

XML comment includes invalid XML 

thay vì những nhận xét tóm tắt.

Làm cách nào để thoát khỏi các ký tự < và>?

Answer 1

Giải pháp tốt nhất mà tôi tìm thấy là để thay đổi nó để thay thế < với < và> với >

như được tìm thấy trong XML specifications.

Điều đó làm ví dụ xem xét như sau:

/// <summary> 
    /// Creates a FlowSegment based on an HTML code, i.e. &lt;bold&gt; 
    /// </summary> 
    /// <param name="code"></param> 
    /// <returns></returns> 
    public FlowSegment(string code) 
    { 

Mà làm cho màn hình hiển thị công cụ-tip mong muốn đúng cách.