J'aimerais que certains outil, de préférence un qui se branche sur VS 2008/2010, qui passera par mes méthodes et ajouter des commentaires XML sur les exceptions possibles qu'ils peuvent lancer. Je ne veux pas l' <summary>
ou d'autres balises XML à générer pour moi parce que je vais remplir ces moi-même, mais ce serait bien si même sur private
/protected
méthodes, je pouvais voir les exceptions susceptibles d'être levées. Sinon je suis aller à travers les méthodes et planant sur tous les appels de méthode à l'intérieur d'eux pour voir la liste des exceptions, puis la mise à jour de cette méthode en <exception
liste de les inclure. Peut-être un VS macro pourrait faire cela?
À partir de ceci:
private static string getConfigFilePath()
{
return Path.Combine(Environment.CurrentDirectory, CONFIG_FILE);
}
Pour cela:
/// <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);
}
Mise à jour: il semble que l'outil aurait à passer par les méthodes de manière récursive, par exemple, method1 appels method2 qui appelle method3 qui est documenté comme jeter NullReferenceException
, de sorte que les deux method2 et method1 sont documentés par l'outil de aussi jeter NullReferenceException
. L'outil serait également nécessaire afin d'éliminer les doublons, comme si deux appels à l'intérieur d'une méthode sont documentées comme jeter DirectoryNotFoundException
, la méthode serait seulement de liste <exception cref="System.IO.DirectoryNotFoundException"/>
une fois.