excepciones de documentos automáticos en métodos en C # /. NET [cerrado]
Me gustaría alguna herramienta, preferiblemente una que se conecte a VS 2008/2010, que revise mis métodos y agregue comentarios XML sobre las posibles excepciones que pueden lanzar. No quiero el<summary>
u otras etiquetas XML que se generarán para mí porque las completaré yo mismo, pero sería bueno si incluso enprivate
/protected
métodos que pude ver qué excepciones podrían ser lanzadas. De lo contrario, me encuentro revisando los métodos y colocando el cursor sobre todas las llamadas de métodos dentro de ellos para ver la lista de excepciones, y luego actualizando los métodos<exception
lista para incluir esos. ¿Quizás una macro VS podría hacer esto?
De esto:
private static string getConfigFilePath()
{
return Path.Combine(Environment.CurrentDirectory, CONFIG_FILE);
}
A esto:
/// <exception cref="System.ArgumentException"/>
/// <exception cref="System.ArgumentNullException"/>
/// <exception cref="System.IO.IOException"/>
/// <exception cref="System.IO.DirectoryNotFoundException"/>
/// <exception cref="System.Security.SecurityException"/>
private static string getConfigFilePath()
{
return Path.Combine(Environment.CurrentDirectory, CONFIG_FILE);
}
Actualizar: parece que la herramienta tendría que pasar por los métodos de forma recursiva, por ejemplo, el método1 llama al método2, que llama al método3, que se documenta como lanzamientoNullReferenceException
, por lo que tanto el método2 como el método1 están documentados por la herramienta como también arrojandoNullReferenceException
. La herramienta también necesitaría eliminar duplicados, como si dos llamadas dentro de un método se documentan como lanzadasDirectoryNotFoundException
, el método solo enumeraría<exception cref="System.IO.DirectoryNotFoundException"/>
una vez.