System.NotImplementedException 類別

本文提供此 API 參考文件的補充備註。

NotImplementedException當特定方法、get 存取子或 set 存取子呈現為型別的成員，但未實作時，就會擲回例外狀況。

NotImplementedException 會使用支持參考相等的預設 Object.Equals 實作。 如需 實例 NotImplementedException的初始值清單，請參閱建 NotImplementedException 構函式。

擲回例外狀況

當該成員仍在開發中，且稍後才會在生產程式代碼中實作時，您可以選擇在您自己的類型中擲回 NotImplementedException 例外狀況。 換句話說，例外 NotImplementedException 狀況應該與「仍在開發中」同義。

處理例外狀況

例外 NotImplementedException 狀況表示您嘗試叫用的方法或屬性沒有實作，因此不會提供任何功能。 因此，您不應該在 區塊中 try/catch 處理此錯誤。 相反地，您應該從程式碼中移除成員調用。 在連結庫的生產版本中實作成員時，您可以包含對成員的呼叫。

在某些情況下， NotImplementedException 可能無法使用例外狀況來表示仍在生產階段前連結庫中開發的功能。 不過，這仍然表示功能無法使用，而且您應該從程式代碼中移除成員調用。

NotImplementedException 和其他例外狀況類型

.NET 也包含另外兩種例外狀況類型， NotSupportedException 以及 PlatformNotSupportedException，表示類型的特定成員沒有實作。 您應該在下列情況下擲回其中一個 NotImplementedException ，而不是例外狀況：

• PlatformNotSupportedException如果您設計了一或多個成員的類型，但在某些平臺或版本上提供，但不是其他版本，則會在不支援此功能的平臺上擲回例外狀況。

• NotSupportedException如果無法實作介面成員或抽象基類方法的覆寫，則擲回例外狀況。

  例如，方法會NotSupportedException擲回例外狀況，Convert.ToInt32(DateTime)因為日期和時間與32位帶正負號的整數之間沒有有意義的轉換。 在此情況下，方法必須存在，因為 Convert 類別會實作 IConvertible 介面。

如果您已實作抽象基類，並將新的成員新增至必須由衍生類別覆寫，則也應該擲回 NotSupportedException 例外狀況。 在此情況下，讓成員抽象化會導致現有的子類別無法載入。