Комментарии 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 ответа:
Правильный синтаксис XML-это
&
, т. е.''' <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>
Основываясь на обсуждении здесь я решил использовать
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.