下列指南讨论了为库用户介绍的一个潜在的变化。如果你把值添加到先前已被承载的枚举中,那么现有的应用程序代码将不再是足够健壮的也不能够优雅地对新值进行处理。
考虑在枚举中添加一个值,尽管这样做存在一个小的兼容性风险。
这个指导方针是与你在期望对库的多个版本进行承载的时候相关的。尽最大的可能来最小化由于在现有的枚举中添加值而造成的代码被破坏的程度,你可以实现能够返回完整值集合的新成员并使用 ObsoleteAttribute 特性来对现有成员进行屏蔽(返回原始的值集合)。如果破坏变化是不可接受的,那么你可以定义一个新的枚举以及与其一起运作的被关联的成员,并把现有的成员和枚举屏蔽成被废弃的。