XML-комментарии Visual Studio (сводные) и специальные символы
У меня есть метод в C# / проект Wpf, и я хотел бы прокомментировать / документируют его с помощью XML-комментариев как это
/// <summary>
/// Initialises Drag & Drop
/// </summary>
void initDragDrop()
{
}
Когда я теперь использую этот метод где-нибудь в моем проекте и парении мышь по нему, я добираюсь, сообщение "XML-комментарий содержит недопустимый XML: В этом месте никакие пробелы не позволяются" (я перевел текст после двоеточия вручную английскому языку, таким образом, это не может быть буквально в Вашей Visual Studio). Я узнал, что проблема "и" знак, если я удаляю его, это хорошо работает. Но я хочу сохранить его, поэтому как я выхожу из него в сводке XML? Я попробовал "\&", но это не работает.
Спасибо за любую подсказку!
1 ответ
Помните, что символ & имеет особое значение в xml (начало объекта). Вместо этого вам нужно написать свой комментарий следующим образом (это раздражает, я знаю):
/// <summary>
/// Initialises Drag & Drop
/// </summary>
void initDragDrop()
{
}
Я могу ошибаться в следующем пункте, но я не думаю, что вы даже можете использовать раздел CDATA, чтобы избежать объекта, потому что он нарушает Комментарии. Вы должны ввести всю сущность & .