2011-05-30 21 views
5

Estoy haciendo documentación en línea en una API, utilizando XML en los comentarios, y me gustaría mantener la sangría. Cada vez que se formatea el documento (CTRL + K CTRL + D), se elimina toda la sangría dentro/* * /. ¿Hay alguna opción para evitar que esto suceda? Parece que puedo mantener la sangría si uso comentarios de una sola línea, pero prefiero no recurrir a esto. Gracias por tu tiempo.Impedir el formato de comentarios en Visual Studio 2010

/* 
<ObjectProperty Name="id" Type="string" DefaultValue="''"> 
<Description> 
Unique identifier of the data store. Primarily used for getting a handle <docref class="ObjectManager">ObjectManager</docref>. 
</Description> 
<Examples> 
<Example> 
// Create an anonymous DataStore 
// Update and Sort the data by using ObjectManager 
new DataStore({ id: 'PersonsDS' }); 
ObjectManager.GetDataStore('PersonsDS').UpdateData([ 
{ 
ID: 1, 
FirstName: 'Joe', 
LastName: 'Bloggs' 
}, 
{ 
ID: 2, 
FirstName: 'Jane', 
LastName: 'Doe' 
} 
]).Sort('LastName', 'desc'); 
</Example> 
</Examples> 
</ObjectProperty> 
*/ 

debe ser similar

/* 
<ObjectProperty Name="id" Type="string" DefaultValue="''"> 
    <Description> 
     Unique identifier of the data store. Primarily used for getting a handle <docref class="ObjectManager">ObjectManager</docref>. 
    </Description> 
    <Examples> 
     <Example> 
      // Create an anonymous DataStore 
      // Update and Sort the data by using ObjectManager 
      new DataStore({ id: 'PersonsDS' }); 
      ObjectManager.GetDataStore('PersonsDS').UpdateData([ 
      { 
       ID: 1, 
       FirstName: 'Joe', 
       LastName: 'Bloggs' 
      }, 
      { 
       ID: 2, 
       FirstName: 'Jane', 
       LastName: 'Doe' 
      } 
      ]).Sort('LastName', 'desc'); 
     </Example> 
    </Examples> 
</ObjectProperty> 
*/ 
+1

No puedo reproducir este comportamiento. – Dave

+0

@Dave Está pegando el segundo bloque de código en VS2010; formatear el documento; y no estás perdiendo la sangría? Eso me daría la esperanza de que ES posible. – Brett

+1

Sí, tomé su segundo bloque de código (formateado), lo pegué en mi editor, presioné CTRL-K, CTRL-D, y se volvió a formatear todo el código en la página, pero dejé intactos sus comentarios. – Dave

Respuesta

1

En Visual Studio 2010 con Productivity Power Tools instalado (extensión gratuita de Microsoft, una herramienta imprescindible), este problema no existe - el formato se conserva en los comentarios cuando el archivo es formateado automáticamente a través de Ctrl + K, D.