| 屬性 | 值 |
|---|---|
| 規則識別碼 | CA1065 |
| Title | 不要在非預期的位置中引發例外狀況 |
| Category | 設計 |
| 修正是破壞性或非破壞性 | 不中斷 |
| 預設啟用於 .NET 10 版本 | 否 |
| 在 .NET 11 中預設啟用 | 否 |
| 適用語言 | C# 與 Visual Basic |
原因
方法預期不會拋出例外狀況,卻拋出了例外狀況。
規則描述
不預期擲回例外狀況的方法可以分類如下:
- 屬性的 "get" 方法
- 事件存取子方法
- Equals 方法
- GetHashCode 方法
- ToString 方法
- 靜態建構函式
- 終結器
- Dispose 方法
- 等號比較運算子
- 隱含轉換運算子
下列各節將討論這些方法類型。
屬性的 "get" 方法
屬性基本上是智慧欄位。 因此,它們的行為應該盡可能像欄位一樣。 欄位不會擲回例外狀況,屬性也不應該擲回。 如果您有擲回例外狀況的屬性,請考慮將它設為方法。
您可以從屬性 get 方法擲回下列例外狀況:
- System.InvalidOperationException 以及所有衍生類型(包括 System.ObjectDisposedException)
- System.NotSupportedException 以及所有衍生版本
- System.ArgumentException (僅來自索引 get)
- System.Collections.Generic.KeyNotFoundException (僅來自索引 get)
事件存取子方法
事件存取子應該是簡單的操作,並且不會擲回例外狀況。 當您嘗試新增或移除事件處理程式時,事件不應該擲回例外狀況。
可以從事件存取器擲回下列例外狀況:
- System.InvalidOperationException 以及所有衍生類別(包括 System.ObjectDisposedException)
- System.NotSupportedException 以及所有衍生項
- System.ArgumentException 及其衍生項目
Equals 方法
下列 Equals 方法不應該擲回例外狀況:
Equals方法應該傳回true或false,而不是擲回例外狀況。 例如,如果 Equals 傳遞了兩個不相符的類型,它應該只會傳回 false ,而不是擲回 ArgumentException。
GetHashCode 方法
下列 GetHashCode 方法通常不應該擲回例外狀況:
GetHashCode 應該總是回傳一個值。 否則,您可能會遺失哈希表中的項目。
採用 自變數的 GetHashCode 版本可能會擲回 ArgumentException。 不過,Object.GetHashCode 不應該拋出例外。
ToString 方法
調試程式會使用 System.Object.ToString 來協助以字串格式顯示對象的相關信息。 因此, ToString 不應該變更物件的狀態,而且不應該擲回例外狀況。
靜態建構函式
從靜態建構函式擲回例外狀況會導致類型在目前的應用程式域中無法使用。 您應該有充分的理由(例如安全性問題)從靜態建構函式擲回例外狀況。
終結器
從終結器擲回例外狀況會導致 CLR 快速失敗,這會中止處理程序。 因此,請避免在終結器中拋出例外。
Dispose 方法
System.IDisposable.Dispose方法不應該丟出例外狀況。
Dispose 通常會在 finally 子句的清理邏輯中呼叫。 因此,從 Dispose 明確地擲出例外狀況,會強制使用者在 finally 子句中新增例外狀況處理。
代碼路徑 Dispose(false) 絕對不應該拋出例外,因為 Dispose 幾乎總是從終結器呼叫。
等號運算子 (==, !=)
像 Equals 方法一樣,等號運算符應該傳回 true 或 false,而且不應擲回例外狀況。
隱含轉換運算子
由於使用者通常不知道已呼叫隱含轉換運算符,因此隱含轉換運算子擲回的例外狀況是非預期的。 因此,不應從隱含轉換運算子拋出任何例外狀況。
如何修正違規
針對屬性 getter,請變更邏輯,使其不再需要擲回例外狀況,或將 屬性變更為方法。
針對先前列出的所有其他方法類型,請變更邏輯,使其不再擲回例外狀況。
隱藏警告的時機
如果違規是由例外狀況宣告所造成,而不是擲回的例外狀況,則隱藏來自此規則的警告是安全的。
隱藏警告
如果您只想要隱藏單一違規,請將預處理器指示詞新增至原始程式檔以停用,然後重新啟用規則。
#pragma warning disable CA1065
// The code that's violating the rule is on this line.
#pragma warning restore CA1065
若要停用檔案、資料夾或專案的規則,請在組態檔中將其嚴重性設為 none。
[*.{cs,vb}]
dotnet_diagnostic.CA1065.severity = none
如需詳細資訊,請參閱 如何隱藏程式代碼分析警告。