CA1711：識別項名稱不應該使用不正確的後置字元
型別名稱 |
IdentifiersShouldNotHaveIncorrectSuffix |
CheckId |
CA1711 |
類別 |
Microsoft.Naming |
中斷變更 |
中斷 |
原因
識別項的後置字元錯誤。
規則描述
依照慣例，只有擴充特定基底型別 (Base Type) 或實作特定介面的型別名稱，或是從這些型別衍生的型別名稱，應以特定保留的後置字元結尾。其他型別名稱不得使用這些保留的後置字元。
下表列出保留的後置字元和關聯的基底型別與介面。
後置字元 |
基底型別/介面 |
|---|---|
屬性 |
|
Collection |
|
Dictionary |
|
EventArgs |
|
EventHandler |
事件處理常式委派 |
例外狀況 |
|
使用權限 |
|
Queue |
|
堆疊 |
|
資料流 |
此外，不可使用下列後置字元：
委派
Enum
Impl - 請改用 'Core'
Ex 或類似的後置字元，使其與相同型別較早的版本有所區別
命名慣例會為針對 Common Language Runtime 的程式庫提供通用的外觀。如此可縮短新軟體程式庫的學習過程，並讓客戶深信程式庫是由學有專長的人員以不斷開發的 Managed 程式碼開發而成。
如何修正違規
請移除型別名稱的後置字元。
隱藏警告的時機
除非在應用程式定義域中後置字元有明確的意義，否則請不要隨意隱藏這項規則的警告。