Duda con Visual Studio 2013

Iniciado por JonaLamper, 3 Octubre 2015, 17:04 PM

0 Miembros y 1 Visitante están viendo este tema.

JonaLamper

Buenas,

En Eclipse, cuando estamos explicando el código con comentarios, hay una forma sencilla para que al poner un comentario te ponga directamente los parámetros de entrada que tiene el método que estás comentando (por ejemplo).



¿Cómo puedo hacer esto mismo en Visual Studio Express 2013?

Muchas gracias.
Utilizar palabras para hablar de palabras es como utilizar un lápiz para hacer un dibujo de ese lápiz sobre el mismo lápiz.

Eleкtro

#1
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.aspx

Es 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:
Código (vbnet) [Seleccionar]

''' <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








JonaLamper

Con la versión Express no me deja  :-\
Utilizar palabras para hablar de palabras es como utilizar un lápiz para hacer un dibujo de ese lápiz sobre el mismo lápiz.

DeMoNcRaZy

Cita de: JonaLamper en  4 Octubre 2015, 20:48 PM
Con la versión Express no me deja  :-\

Podrías intentar bajarte la versión gratuita "Community" 2015: https://www.visualstudio.com/es-es/downloads/download-visual-studio-vs.aspx

Yo la uso y personalmente me funciona correctamente y muy bien todo.

Saludos.
Esta página web no está disponible - Google Chrome

JonaLamper

Por mí me bajaría cualquiera. El problema es que me "obligan" a usar esa (universidad...).

Utilizar palabras para hablar de palabras es como utilizar un lápiz para hacer un dibujo de ese lápiz sobre el mismo lápiz.

Eleкtro

Las ediciones Express tienen una gran limitación que has descuerbierto por ti mismo, si que es posible instalar extensiones, pero jamás se llegarán a cargar/iniciar en la IDE, esto es debido a una decisión de funcionalidad de Microsoft.

El único remedio para esto es que instales una edición más avanzada, ya sea Pro, Enterprise o Ultimate. (los nombres de las ediciones varian según la versión de Visual Studio...)

Si no puedes instalarte otra versión entonces sencillamente no hay nada que hacer.

PD: Nunca he probado la versión no-oficial Comunity, pero supuestamente también permite instalar extensiones.

Saludos.