Ajout de valeurs à des énumérations

La règle suivante traite de l'introduction d'une nouveauté pour les utilisateurs de vos bibliothèques. Si vous ajoutez des valeurs à une énumération fournie antérieurement, il est possible que le code d'application existant ne soit pas assez fiable pour gérer correctement les nouvelles valeurs.

Envisagez d'ajouter des valeurs aux énumérations en dépit d'un léger risque de compatibilité.

Cette règle est pertinente lorsque vous prévoyez de commercialiser plusieurs versions de votre bibliothèque. Pour limiter les interruptions de code résultant de l'ajout de valeurs à une énumération existante, vous pouvez implémenter des nouveaux membres qui retournent l'ensemble complet de valeurs et marquent les membres existants (qui retournent l'ensemble de valeurs d'origine) à l'aide de l'attribut ObsoleteAttribute. Si l'introduction de nouveautés n'est pas admise, vous pouvez définir une nouvelle énumération ainsi que les membres qui lui sont associés et marquer l'énumération et les membres existants comme étant obsolètes.

Portions Copyright 2005 Microsoft Corporation. Tous droits réservés.

Portions Copyright Addison-Wesley Corporation. Tous droits réservés.

Pour plus d'informations sur les règles de conception, consultez « règles de conception d'infrastructure : Conventions idiomes et modèles carnet de bibliothèques réutilisables framework » Krzysztof Cwalina et Brad Abrams, publiés par Addison-Wesley, 2005.

Voir aussi

Concepts

Conception d'énumérations

Conception d'énumérations d'indicateurs

Autres ressources

Instructions de conception de types

Instructions de conception pour le développement de bibliothèques de classes