Відображення коментарів XML у новому рядку

У Visual Studio ви можете писати коментарі XML-документів на C# і VB.NET властивості та методи. Після того, як ви напишете його, ви зможете переглянути опис властивості або методу, коли будете писати його в коді, навести курсор миші і використовувати такий інструмент, як "Sandcastle".

Однак, якщо ви напишете занадто багато, читабельність знизиться, тому зазвичай ви будете писати його приблизно в одному рядку, але в деяких випадках ви можете захотіти відобразити його на декількох рядках.

Якщо ви зазвичай ламаєте рядок у коментарі, ви очікуєте, що він буде відображатися з розривом рядка під час відображення опису, але коли ви насправді спробуєте, він буде відображатися наступним чином.

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

Результат відображення пояснень

У тексті опису немає розривів рядків, а макет виглядає так, ніби містить пробіли. XML має різний вплив на те, як обробляються пробіли та розриви рядків, і Visual Studio не вважає звичайні розриви рядків розривами тексту.

Отже, якщо ви хочете розбити текст опису на рядок, як це зробити - використовувати тег "para". "para" означає "абзац". Візьміть одиниці, які ви хочете розірвати, як це робиться в абзацному тегу:

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

Опис відображається з розривом рядка, як показано на малюнку. Якщо ви використовуєте інструмент генерації документа, він також з'явиться у вигляді абзацу з розривами рядків.