stile

Question

questo può sembrare una domanda banale, ma quando ho installato il plugin StyleCop per ReSharper i miei commenti sono sempre formattato come questo

/// <summary> 
/// Gets the gift item. 
/// </summary> 
/// <param name="uid"> 
/// The uid. 
/// </param> 
/// <param name="upc"> 
/// The upc. 
/// </param> 
/// <returns> 
/// </returns> 
Gift GetGift(long uid, string upc); 

al contrario di

/// <summary>Gets the gift item.</summary> 
/// <param name="uid">The uid.</param> 
/// <param name="upc">The upc.</param> 
/// <returns></returns> 
Gift GetGift(long uid, string upc); 

I non riesco a trovare alcun modo per disattivare questo tipo di formattazione.

Answer 1

Dai una prova a GhostDoc. Questa estensione gratuita di Visual Studio genera commenti di documenti XML ancora più belli. I tag param e return sono in linea mentre i tag summary rimangono su righe separate. Forse questo è già adatto alle tue esigenze.

Answer 2

È possibile rendere GhostDoc funzionante se si disattiva "Rifiuta i commenti dei documenti XML incorporati" nelle impostazioni di pulitura del codice predefinite nella categoria "C#". Quindi, nella sezione StyleCop, disattivare la regola "1611: i parametri dell'elemento devono essere documentati" e la regola "1618: i parametri di tipo generico devono essere documentati". In questo modo la pulizia del codice non riorganizzerà i tuoi commenti GhostDoc. Ricordare che le opzioni di pulizia del codice sono specifiche della soluzione.

Answer 3

Se si dispone del plug-in Microsoft Stylecop per Resharper installato in Resharper, passare a Opzioni di richiamo, Strumenti, quindi a StyleCop per Resharper. Lì dovresti vedere una casella di controllo Usa le righe singole per le intestazioni delle dichiarazioni.