Para exibir comentários XML em uma nova linha

No Visual Studio, você pode escrever comentários de documentos XML sobre propriedades e métodos C# e VB.NET. Uma vez que você escrevê-lo, você será capaz de visualizar a descrição da propriedade ou método quando você escrevê-lo em código, pairar o cursor do mouse e usar uma ferramenta como "Sandcastle".

No entanto, se você escrever demais, a legibilidade diminuirá, então geralmente você vai escrevê-la em cerca de uma linha, mas em alguns casos você pode querer exibi-la em várias linhas.

Se você quebrar uma linha em um comentário normalmente, você espera que ela seja exibida com uma quebra de linha quando a descrição for exibida, mas quando você realmente experimentá-lo, ele será exibido da seguinte forma.

/// <summary>
/// これは
/// 普通に
/// 改行したもの
/// <summary>
public int Amount1 { get; set; }

Resultado do display de explicação

Não há quebras de linha no texto de descrição, e o layout parece que contém espaços. O XML tem um efeito variado sobre como o espaço branco e as quebras de linha são manuseadas, e o Visual Studio não considera que as quebras de linha normais sejam quebras de texto.

Então, se você quiser quebrar o texto de descrição em uma linha, como fazê-lo é usar a tag "para". "para" significa "parágrafo". Inclua as unidades que você deseja quebrar linhas como esta em uma etiqueta para:

/// <summary>
/// <para>paraを</para>
/// <para>使って</para>
/// <para>改行したもの</para>
/// </summary>
public int Amount2 { get; set; }

A descrição é exibida com uma quebra de linha, como mostrado na figura. Se você usar a ferramenta de geração de documentos, ela também aparecerá como um parágrafo com quebras de linha.