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

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

原因

識別項的後置字元錯誤。

規則描述

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

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

後置字元	基底型別/介面
屬性	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	事件處理常式委派
例外狀況	System.Exception
使用權限	System.Security.IPermission
Queue	System.Collections.Queue
堆疊	System.Collections.Stack
資料流	System.IO.Stream

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

• 委派

• Enum

• Impl - 請改用 'Core'

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

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

如何修正違規

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

隱藏警告的時機

請勿隱藏此規則的警告。

相關規則

CA1710：識別項應該使用正確的後置字元

請參閱

參考

Attribute Usage Guidelines

其他資源

事件和委派