共用方式為


將值加入至列舉型別

更新:2007 年 11 月

下列方針將討論如何針對程式庫的使用者引入可能是最新的變更。如果您將值加入到之前推出的列舉型別中,則現有的應用程式之程式碼可能不會強固到足以輕鬆地處理新的值。

儘管有些微的相容性風險,還是要考慮將值加入到列舉型別中。

當您預期要推出一個版本以上的程式庫時,這個方針就會很適合。若要盡量減少因為將值加入至現有的列舉型別而中斷的程式碼,您可以使用 ObsoleteAttribute 屬性實作會傳回一組完整值的新成員,並標記現有的成員 (會傳回一組原始值)。如果最新的變更不被接受,您可以定義新的列舉型別以及使用它的關聯成員,並將現有的成員和列舉型別標記為已過時。

Portions Copyright 2005 Microsoft Corporation.All rights reserved.

Portions Copyright Addison-Wesley Corporation.All rights reserved.

如需設計方針的詳細資訊,請參閱由 Krzysztof Cwalina 和 Brad Abrams 所著,並由 Addison-Wesley 於 2005 年發行的「Framework 設計方針:可重複使用之 .NET 程式庫的慣例、慣用語法和模式」一書。

請參閱

概念

列舉型別設計

設計旗標列舉型別

其他資源

型別設計方針

開發類別庫的設計方針