Комментарии VS2010 с амперсандом " & " помечаются как предупреждения


Это может быть простой вещью, но в VB2010 я люблю размещать свои источники в обычных комментариях. Некоторые URL-адреса имеют встроенные амперсанды, и это помечается IDE как предупреждение.

''' <summary>
''' routine that creates a new file based on a definition query.
''' </summary>
''' <param name="newLoc"></param>
''' <returns></returns>
''' <remarks>
''' http://forums.esri.com/Thread.asp?c=93&f=992&t=194920#580036
''' http://forums.esri.com/Thread.asp?c=93&f=992&t=155005#452664
''' </remarks>
Public Function DoSelectLoc(ByVal newLoc As NewLocation) As Boolean
   'my routine
End Function

Два URL-адреса выше помечаются предупреждением. Я попробовал несколько альтернативных способов написать URL, но ни один из них не сработал. Я пробовал HTML-код &, но у него все еще есть амперсанд. Я знаю, что IDE использует XML для комментариев, но должен быть какой-то способ написать URL-адрес без получения предупреждения и все еще сохраняя ту же ссылку.

Обновление: на основе обсуждения здесь http://social.msdn.microsoft.com/Forums/en-US/f14e7b55-c352-4ca5-a82c-bca3b83818db/double-ampersand-in-a-code-comment-causes-intellisense-error я решил использовать CDDATA для инкапсуляции моих URL-адресов следующим образом:

''' <remarks>
''' <![CDATA[
''' http://forums.esri.com/Thread.asp?c=93&f=992&t=194920#580036
''' http://forums.esri.com/Thread.asp?c=93&f=992&t=155005#452664
''' ]]>
''' </remarks>

, кажется, работает, чтобы ссылки работали правильно, а также не отключать предупреждение Visual Studio.

2 4

2 ответа:

Правильный синтаксис XML-это &amp;, т. е.

''' <remarks>
''' http://forums.esri.com/Thread.asp?c=93&amp;f=992&amp;t=194920#580036
''' http://forums.esri.com/Thread.asp?c=93&amp;f=992&amp;t=155005#452664
''' </remarks>

Основываясь на обсуждении здесь я решил использовать CDATA для инкапсуляции моих URL-адресов следующим образом:

''' <remarks>
''' <![CDATA[
''' http://forums.esri.com/Thread.asp?c=93&f=992&t=194920#580036
''' http://forums.esri.com/Thread.asp?c=93&f=992&t=155005#452664
''' ]]>
''' </remarks>

, кажется, работает, чтобы ссылки работали правильно, а также не отключать предупреждение Visual Studio.