Резюме, неправильно сформированный XML-комментарий игнорируется для участника - PullRequest
12 голосов
/ 08 сентября 2011

Я документирую своих учеников в VS 2010 с атрибутом Summary. Когда я собираю проект, файл XML - это сборка (я буду использовать его позже при разработке). Одно из резюме участника класса не включено в XML-файл, вместо этого появляется сообщение об ошибке «Плохо сформированный XML-комментарий игнорируется для участника».

Сводка текста ниже. Я не понимаю, что форматируется неправильно. Должен ли я экранировать символ & и использовать вместо него %26?

    /// <summary>
    /// URI of a web page to convert. Must start with http:// or https://. Several URI of web pages can be passed to create one PDF. For example if http://www.google.com+http://www.nytimes.com URI will be passed the two web pages will be merged into one PDF.
    /// If URI has special characters like ? or & they must be encoded.
    /// </summary>

Ответы [ 2 ]

21 голосов
/ 08 сентября 2011

Поскольку это XML, вы должны кодировать специальные символы.Ваш знак & (ранее меня укусил) необходимо заменить на &amp;.

3 голосов
/ 08 сентября 2011

Да, вы должны экранировать &, как &amp;.

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...