Para mostrar comentarios XML en una nueva línea

En Visual Studio, puede escribir comentarios de documentos XML en C# y VB.NET propiedades y métodos. Una vez que lo escriba, podrá ver la descripción de la propiedad o el método cuando lo escriba en código, pase el cursor del mouse y use una herramienta como "Sandcastle".

Sin embargo, si escribe demasiado, la legibilidad disminuirá, por lo que generalmente lo escribirá en aproximadamente una línea, pero en algunos casos es posible que desee mostrarlo en varias líneas.

Si rompe una línea en un comentario normalmente, esperará que se muestre con un salto de línea cuando se muestre la descripción, pero cuando realmente lo intente, se mostrará de la siguiente manera.

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

Explicación del resultado de la visualización

No hay saltos de línea en el texto de descripción y el diseño parece que contiene espacios. XML tiene un efecto variable en la forma en que se controlan los saltos de línea y los saltos de línea, y Visual Studio no considera que los saltos de línea normales sean saltos de texto.

Por lo tanto, si desea romper el texto de descripción en una línea, cómo hacerlo es usar la etiqueta "para". "para" significa "párrafo". Encierre las unidades que desea romper líneas como esta en una etiqueta para:

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

La descripción se muestra con un salto de línea como se muestra en la figura. Si utiliza la herramienta de generación de documentos, también aparecerá como un párrafo con saltos de línea.