NewLine no resumo do objeto

saudações

Ao definir um resumo para uma propriedade / campo / método etc. é possível ter uma nova linha nele?

/// <summary>
/// This is line 1
/// This is line 2
/// </summary>
public bool TestLine { get; set; }

Quando eu defino isso, mostra como ao passar o mouse:

bool TestLine
This is line 1 This is line 2

Mas quero que seja mostrado como:

bool TestLine
This is line 1 
This is line 2

Já tentei usar, \nmas não deu certo. Existe alguma maneira de fazer isso?

Você quer usar algo assim

/// <summary> 
/// Your Main comment 
/// <para>This is line 1</para> 
/// <para>This is line 2</para> 
/// </summary> 
public bool TestLine { get; set; }

Sim:

/// <summary> 
/// Main comment 
/// <para>Line 1</para> 
/// <para>Line 2</para> 
/// </summary> 
public bool TestLine { get; set; }

Este pode ser um tópico antigo, mas eu estava procurando por um anwser enquanto usava o Visual Studio 2019 . Eu queria quebras de parágrafo e linhas. O seguinte funciona bem para mim:

/// <summary>
/// <para>parameter name="guidType" options:</para>
/// <br>0 = SequentialAsString</br>
/// <br>1 = SequentialAsBinary</br>
/// <br>2 = SequentialAtEnd</br>
/// </summary>

Produz o seguinte:

parameter name="guidType" options:

0 = SequentialAsString
1 = SequentialAsBinary
2 = SequentialAtEnd

Você pode usar <para />para adicionar uma nova linha ao resumo:

/// <summary> 
/// Main comment<para />
/// Line 1<para />
/// Line 2<para />
/// </summary>
public bool TestLine { get; set; }

Parece:

Main comment
Line 1
Line 2

Cumprimentos!

Estou apenas adicionando isso para qualquer pessoa que use o Xamarin Studio como eu. Descobri que nenhuma das soluções acima funcionam para mim, mas esta funcionou:

/// <summary>
/// Main summarry line.
/// <para></para>
/// <para></para>
/// Your secondary summary
/// </summary>

Isso dá a seguinte saída:

Summary  
Main summary line.

Your secondary summary

Se você estiver usando o Swashbuckle (biblioteca de integração do Swagger Web API), ele <para></para>deve ser substituído por <p></p>e <br/>também pode ser usado.

então o seguinte

    /// <para>
    ///     Flag1, Flag2
    ///     - bool flags, optional.
    /// </para>

torna-se

    /// <p>
    ///     Flag1, Flag2<br/>
    ///     - bool flags, optional.
    /// </p>

O problema já está descrito aqui: Como adicionar quebra de linha à documentação do Swashbuckle? - usando uma configuração especial, o comentário do domaindrivendev, https://github.com/domaindrivendev/Swashbuckle/issues/258 - no <br/>uso.

Você pode adicionar tags para legitimamente, mas isso na verdade cria um novo parágrafo para cada nova linha e o espaçamento entre linhas aparece desligado.
Eu pessoalmente adiciono 1 parágrafo ao redor do parágrafo e, em seguida, brmarcações no final das linhas nas quais eu queria uma pausa, o que preserva um espaçamento de linha decente:

/// <summary> 
/// <para>Main comment<br /> 
/// Line 1<br />
/// Line 2</para> 
/// </summary>
public bool TestLine { get; set; }

Eu sugeriria usar essa formatação se você quiser várias linhas no resumo sem complicar. Funcionará se você usar a tag <br /> após cada linha. (usá-lo em qualquer lugar dentro do texto criará uma nova linha onde a tag também está.)

Porém, observe que se você tiver um espaço após a tag <br />, receberá um espaço extra na próxima linha. Então você quer ter a mesma quantidade de espaço em cada linha, então cada linha será em linha reta.

/// <summary>
/// This is line 1<br />
/// This is line 2<br />
/// This is line 3<br />
/// </summary>
public bool TestLine { get; set; }