共用方式為


將值加入至列舉型別

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

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

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

Portions Copyright 2005 Microsoft Corporation. All rights reserved.

Portions Copyright Addison-Wesley Corporation. All rights reserved.

設計指引的詳細資訊,請參閱"框架設計準則:公約、 成語和可重複使用的模式。網路圖書館"書 Krzysztof Cwalina 和布拉德 · 艾布拉姆斯,2005年艾迪生 - 衛斯理,發表。

請參閱

概念

列舉設計

設計旗標列舉型別

其他資源

型別設計方針

開發類別庫的設計方針