Comentários de multilinha XML em C # - o que estou fazendo de errado?
De acordo comEste artigo, é possível obter comentários XML com várias linhas - em vez de usar///
, usar/** */
. Esta é a minha interpretação do que são comentários multilinhas e o que eu quero que aconteça:
/**
* <summary>
* this comment is on line 1 in the tooltip
* this comment is on line 2 in the tooltip
* </summary>
*/
No entanto, quando eu uso este formulário, a dica de ferramenta que aparece quando passe o mouse sobre o nome da minha classe no meu código é de linha única, ou seja, parece exatamente como se eu tivesse escrito meu comentário assim:
/// <summary>
/// this comment is on line 1 in the tooltip
/// this comment is on line 2 in the tooltip
/// </summary>
Esse comportamento ainda é possível no VS2008?
EDITAR
gabe apontou que eu não entendi o que "multilinha" significa e eu realmente preciso usar<para>
ou<br>
para obter o efeito pretendido. Fui em frente e usei<br>
porque quero controlar onde ocorrem as quebras de linha, ou seja,
/// <summary>
/// this comment is on line 1 in the tooltip<br/>
/// this comment is on line 2 in the tooltip<br/>
/// </summary>
Quando olho para a dica de ferramenta para essa classe no meu código, tudo ainda acaba em uma linha ... WTH? Eu fiz algo errado aqui?
ATUALIZAR
Ok, eu fui em frente e tentei o<para>
tag em cada linha, e isso funciona. Não sei por que<br/>
não.
/// <summary>
/// <para>this comment is on line 1 in the tooltip</para>
/// <para>this comment is on line 2 in the tooltip</para>
/// </summary>