XML-комментарии Visual Studio (сводка) и специальные символы

У меня есть метод в проекте С#/Wpf, и я хотел бы комментировать/документировать его с помощью комментариев XML, подобных этому

    /// <summary>
    /// Initialises Drag & Drop
    /// </summary>
    void initDragDrop()
    {

    }

Когда я сейчас использую этот метод где-то в своем проекте и наведите указатель мыши на него, я получаю сообщение "Комментарий XML содержит недопустимый XML: в этом месте пробелы не допускаются" (я перевел текст после двоеточия вручную на английский, так что это может быть не буквально в вашей визуальной студии). Я выяснил, что проблема - "&". знак, если я удалю его, он отлично работает. Но я хочу сохранить его, так как мне избежать этого в сводке XML? Я попробовал "\ &" но это не работает.

Спасибо за любой намек!

Ответы

Ответ 1

Помните, что символ и имеет особое значение в xml (начало объекта). Вы должны написать свой комментарий, как это вместо (раздражает, я знаю):

/// <summary>
/// Initialises Drag &amp; Drop
/// </summary>
void initDragDrop()
{

}

Возможно, я ошибаюсь в этой следующей точке, но я не думаю, что вы даже можете использовать раздел CDATA, чтобы избежать сущности, потому что он нарушает комментарии. Вы должны набрать весь объект &amp;.