2

Tengo funciones en c# aspx en visual studio 201 con 15 parámetros aproximadamente

function x(param1, param2, etc...){}

y quiero agregarles documentación en la parte de arriba para cada parámetro

/*@param1

*@param2

*etc.

*/

function x(param1, param2, etc...){}

He estado agregando esta documentación de forma manual pero algunas veces escribo mal los parámetros o me olvido de alguno o hago alguna otra cosa mal, quisiera generar esa documentación de forma automática, hay alguna forma de hacerlo en visual studio 2015 o tengo que seguir haciéndolo manualmente?

2 respuestas 2

7

Aparte de lo que menciona @Pikoh, poner ///

introducir la descripción de la imagen aquí

También puedes utilizar algún complemento como:

MZTOOLS - link pagina oficial introducir la descripción de la imagen aquí

Con MzTools puedes armar templates.

Complementos para ayudarte a documentar:

Parece que el ultimo se acerca mas a lo que buscas:

introducir la descripción de la imagen aquí

O buscar algún nuget para manejar tu documentación.

4
  • 2
    Hola cristina tu generaste el gif???,, como ? Commented el 1 feb. 2017 a las 18:57
  • @Rastalovely si lo generé con eta aplicación: ScreenToGif, después lo añadí con el botón de imagen o ctrl + G y listo :-) Commented el 2 feb. 2017 a las 17:26
  • Excelente se ve muy bien, gracias por el aporte. Saludos Commented el 2 feb. 2017 a las 17:28
  • Gracias y para tus futuras respuestas ya tendrás una nueva opción, la de insertar un gif en caso de ser necesario. :-) Commented el 2 feb. 2017 a las 17:30
7

En visual Studio, si añades 3 slashes /// antes de un método, se te genera un texto con el sumario del método y los parámetros de entrada y salida para rellenar, algo asi:

/// <summary>
/// 
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void cmbIpp_SelectedIndexChanged(object sender, EventArgs e)

De hecho,utilizando <summary> el texto que añadas,asi como la explicación de los parámetros te apareceran en el Intellisense al usar el método, lo cual es muy util.

1
  • Hay alguna forma de hacer lo mismo pero con templates, lo que pasa es que tengo parametros out y ref y en esa documentacion no hay como distinguirlos
    – YHAM
    Commented el 1 feb. 2017 a las 18:05

Tu Respuesta

By clicking “Publica tu respuesta”, you agree to our terms of service and acknowledge you have read our privacy policy.

¿No es la respuesta que buscas? Examina otras preguntas con la etiqueta o formula tu propia pregunta.