識別項名稱不應該使用不正確的後置字元

更新：2007 年 11 月

型別名稱	IdentifiersShouldNotHaveIncorrectSuffix
CheckId	CA1711
分類	Microsoft.Naming
中斷變更	中斷

原因

識別項的後置字元錯誤。

規則描述

依照慣例，只有擴充特定基底型別 (Base Type) 或實作特定介面的型別名稱，或是從這些型別衍生的型別名稱，應以特定保留的後置字元結尾。其他型別名稱不得使用這些保留的後置字元。

下表列出保留的後置字元和關聯的基底型別與介面。

後置字元	基底型別/介面
Attribute	System.Attribute
Collection	System.Collections.ICollection System.Collections.IEnumerable System.Collections.Queue System.Collections.Stack System.Collections.Generic.ICollection<T> System.Data.DataSet System.Data.DataTable
Dictionary	System.Collections.IDictionary System.Collections.Generic.IDictionary<TKey, TValue>
EventArgs	System.EventArgs
EventHandler	事件處理常式委派
Exception	System.Exception
Permission	System.Security.IPermission
Queue	System.Collections.Queue
Stack	System.Collections.Stack
Stream	System.IO.Stream

此外，不可使用下列後置字元：

• Delegate

• Enum

• Impl - 請改用 'Core'

• Ex 或類似的後置字元，使其與相同型別較早的版本有所區別

命名慣例會為針對 Common Language Runtime 的程式庫提供通用的外觀。如此可縮短新軟體程式庫的學習過程，並讓客戶深信程式庫是由學有專長的人員以不斷開發的 Managed 程式碼開發而成。

如何修正違規

請移除型別名稱的後置字元。

隱藏警告的時機

請勿隱藏此規則的警告。

相關規則

識別項的後置字元應正確

請參閱

概念

事件和委派

參考

屬性用法方針