向枚举添加值

下面的准则讨论如何为库用户引入可能影响重大的更改。 如果向以前提供的枚举添加值,现有应用程序代码可能没有足够的能力妥善处理这些新值。

尽管有一些小的兼容风险,还是请考虑向枚举添加值。

此准则适于在提供多个库版本时使用。 若要使用最少的代码向现有枚举添加值,可实现返回值全集的新成员,并使用 ObsoleteAttribute 特性标记现有成员(返回原始值集的成员)。 如果不希望进行重大更改,则可以定义一个新枚举,以及新枚举的关联成员,并将现有的成员和枚举标记为已过时。

部分版权所有 2005 Microsoft Corporation。 保留所有权利。

部分版权所有 Addison-Wesley Corporation。 保留所有权利。

设计指引的详细信息,请参阅"框架设计准则: 公约、 成语和可重复使用的模式。网络图书馆"书 Krzysztof Cwalina 和布拉德 · 艾布拉姆斯,2005年艾迪生 - 韦斯利,发表。

请参见

概念

枚举设计

设计标志枚举

其他资源

类型设计准则

类库开发的设计准则