estilo COP + control de ReSharper comentarios

Question

esto puede parecer una pregunta trivial, pero cuando he instalado el plugin StyleCop para ReSharper mis comentarios se están formateados como esto

/// <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); 

en contraposición a

/// <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 parece que no puede encontrar ninguna forma de desactivar este tipo de formato.

Answer 1

Prueba GhostDoc para probar. Esta extensión gratuita de Visual Studio genera incluso mejores comentarios de documentos XML. Las etiquetas param y return están en línea, mientras que las etiquetas summary permanecen en líneas separadas. Tal vez esto ya se adapte a tus necesidades.

Answer 2

Puede hacer que GhostDoc funcione si desactiva "Reformatear los comentarios de documento XML incrustados" en su configuración predeterminada de Limpieza de código en la categoría "C#". Luego, en la sección StyleCop, desactive la regla "1611: los parámetros del elemento deben documentarse" y la regla "1618: los parámetros del tipo genérico deben documentarse". De esa forma, la limpieza del código no volverá a modificar sus comentarios de GhostDoc. Tenga en cuenta que las opciones de limpieza de código son específicas de la solución.

Answer 3

Si tiene el Microsoft Stylecop para el complemento Resharper instalado en Resharper, vaya a Opciones de Resharper, Herramientas, y luego StyleCop para Resharper. Allí debería ver una casilla de verificación para Usar líneas únicas para encabezados de declaración.