Как добавить пример кода типа списка в комментарии XML?

Question

Я использовал ниже XML комментарий,

/// <example> 
    /// This example shows how to use <see cref="SampleCollection"/> property. 
    /// <code> 
    /// class TestClass 
    /// { 
    ///  List<string> collection = new List<string>(); 
    ///  collection.Add("Column1"); 
    ///  collection.Add("Column2"); 
    ///  this.SampleCollection = collection; 
    /// } 
    /// </code> 
    /// </example>   
    public List<string> SampleCollection 
    { 
     get; 
     set; 
    } 

Но это следующее предупреждение об ошибке,

XML комментарий на 'SampleCollection' имеет плохо сформирован XML - «Конечный тег 'код' делает не соответствует начальному тегу 'string'. '

потому что определение списка имеет <string>. Поэтому он считал это тегом XML.

Есть ли способ разрешить это?

Answer 1

Используйте CDATA block вставлять необработанный текст в XML:

<![CDATA[ 
List<string> ... 
]]>