Visual Studio aporta una genial ayuda interactiva adicional llamada
IntelliSense para, entre otras cosas, ahorrar tiempo mostrando un panel desplegable con sugerencias, pero no existe una funcionalidad built-in en
Visual Studio que haga lo que pides de forma "completa" o
at once, sin embargo, existen infinidad de herramientas de terceros en forma de extensiones para
VS que te resolverían el problema.
Sin duda alguna te recomiendo
GhostDoc, con la versión gratuita tendrías suficiente.
➢
http://submain.com/products/ghostdoc.aspxEs tan simple como instalarlo, y, estando en el editor de código de Visual Studio, pulsar botón derecho del ratón sobre la firma de un método o en cualqueir parte del bloque, y seleccionar la opción
GhostDoc -> Document this.
O simplemente puedes situar el
caret una linea encima del nombre del método y escribir el identificador de linea de documentación XML, es decir, 3 comillas seguidas en VB ''' o 3 backslashes en C# ///, y automáticamente se generará la documentación XML por defecto para la firma del miembro.
Esto último también puedes hacerlo con el uso de la característica
IntelliSense de
Visual Studio como mencioné al principio, puedes ir añadiéndo la documentación de cada parámetro, uno por uno:
Un ejemplo de la generación automática de código usando
GhostDoc para demostrar un poquito el formato obtenido y la
I.A. empleada:
''' <summary>
''' Converts the string to integer.
''' </summary>
''' <typeparam name="T"></typeparam>
''' <param name="param1">The param1.</param>
''' <param name="isHexEnabled">if set to <c>true</c> [is hexadecimal enabled].</param>
''' <param name="str">The string.</param>
''' <returns><c>true</c> if XXXX, <c>false</c> otherwise.</returns>
''' <exception cref="ArgumentException">message;paramName</exception>
Public Shared Function ConvertStringToInteger(Of T)(ByVal param1 As T, ByVal isHexEnabled As Boolean, ByVal str As String) As Boolean
Throw New ArgumentException("message", "paramName")
End Function
Como puedes comprobar, es bastante inteligente (puedes especificar plantillas en la versión Pro), ahorra tiempo, mucho mejor que culquier solución built-in.
Saludos
Autor
En línea
