Managed 程式碼的程式碼分析警告

Managed 程式碼分析工具提供的警告會指出 Managed 程式碼程式庫中的規則違規。 這些警告會組織成設計、當地語系化、效能和安全性等規則區域。 每一個警告都表示一個 Managed 程式碼分析規則的違規。 本節會針對每個 Managed 程式碼分析警告進行深度討論並提供範例。

下表顯示針對每個警告提供的資訊類型。

項目

說明

型別

規則的型別名稱。

CheckId

規則的唯一識別項。 CheckId 和分類可以用於抑制警告的來源。

分類

警告的分類。

中斷變更

針對規則之違規所進行的修正是否為中斷變更。 中斷變更表示組件 (Assembly) 若對導致違規的目標具有相依性,將不會利用新的修正版本進行重新編譯,或者可能會因變更而於執行階段失敗。 若有多個可用的修正,其中至少有一個修正會中斷變更,但有一個不會中斷變更時,則會同時指定「中斷」和「非中斷」。

原因

導致規則產生警告的特定 Managed 程式碼。

說明

討論警告背後的問題。

如何修正違規

說明如何變更原始程式碼以符合規則,並避免產生警告。

隱藏警告的時機

說明何時可以放心地隱藏規則的警告。

範例程式碼

違反規則的範例,以及符合規則的修正範例。

相關警告

相關警告

在本節中

依據 CheckId 列出 Managed 程式碼的程式碼分析警告

依照 CheckId 列出所有警告。

設計警告

支援 .NET Framework 設計方針所指定之正確程式庫設計的警告。

全球化警告

支援世界性程式庫和應用程式的警告。

互通性警告

支援與 COM 用戶端互動的警告。

維護性警告

支援程式庫和應用程式維護的警告。

行動力警告

支援高效率電力使用方式的警告。

命名警告

支援遵守 .NET Framework 設計方針之命名慣例的警告。

效能警告

支援高效能程式庫和應用程式的警告。

可攜性警告

支援各種不同平台之可攜性的警告。

可靠性警告

支援程式庫和應用程式可靠性的警告,如正確的記憶體和執行緒用法。

安全性警告

支援更安全之程式庫和應用程式的警告。

用法警告

支援適當使用 .NET Framework 的警告。

程式碼分析原則錯誤

簽入時不符合程式碼分析原則所發生的錯誤。