Comment marquer une méthode comme obsolète ou obsolète à l'aide de C # ?
c#
.net
versioning
deprecated
Chris Ballance
la source
la source
[EditorBrowsable(EditorBrowsableState.Never)]
( stackoverflow.com/a/9086345/661933 ). Sert un but légèrement différent.Réponses:
Le moyen le plus court consiste à ajouter l' attribut
ObsoleteAttribute
as à la méthode . Assurez-vous d'inclure une explication appropriée:Vous pouvez également provoquer l'échec de la compilation, en traitant l'utilisation de la méthode comme une erreur au lieu d'un avertissement , si la méthode est appelée quelque part dans un code comme celui-ci:
la source
Pour marquer comme obsolète avec un avertissement:
Vous recevez un avertissement lorsque vous l'utilisez:
Et avec IntelliSense:
Si vous voulez un message:
Voici l'info-bulle IntelliSense:
Enfin, si vous souhaitez que l'utilisation soit signalée comme une erreur:
Lorsqu'il est utilisé, voici ce que vous obtenez:
Remarque: utilisez le message pour indiquer aux utilisateurs ce qu'ils doivent utiliser à la place, et non pourquoi il est obsolète.
la source
Ajoutez une annotation à la méthode à l'aide du mot clé
Obsolete
. L'argument de message est facultatif mais une bonne idée de communiquer pourquoi l'élément est maintenant obsolète et / ou quoi utiliser à la place.Exemple:
la source
Avec
ObsoleteAttribute
vous pouvez afficher la méthode obsolète. L'attribut obsolète a trois constructeurs:la source