CannotRemoveControlException 類別

當程式碼嘗試移除在設計階段加入至文件中的主控制項或 Windows Form 控制項時，所擲回的例外狀況。

繼承階層架構

System.Object
  System.Exception
    Microsoft.VisualStudio.Tools.Applications.Runtime.RuntimeException
      Microsoft.Office.Tools.CannotRemoveControlException

命名空間：  Microsoft.Office.Tools
組件：  Microsoft.Office.Tools.v4.0.Framework (在 Microsoft.Office.Tools.v4.0.Framework.dll 中)

語法

'宣告
<SerializableAttribute> _
<SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted := True)> _
<SecurityPermissionAttribute(SecurityAction.InheritanceDemand, Unrestricted := True)> _
Public NotInheritable Class CannotRemoveControlException _
    Inherits RuntimeException

[SerializableAttribute]
[SecurityPermissionAttribute(SecurityAction.Demand, Unrestricted = true)]
[SecurityPermissionAttribute(SecurityAction.InheritanceDemand, Unrestricted = true)]
public sealed class CannotRemoveControlException : RuntimeException

CannotRemoveControlException 型別會公開下列成員。

建構函式

	名稱	說明
	CannotRemoveControlException()	基礎架構。
	CannotRemoveControlException(Exception)	基礎架構。
	CannotRemoveControlException(String)	基礎架構。
	CannotRemoveControlException(String, Exception)	基礎架構。
	CannotRemoveControlException(String, String)	基礎架構。
	CannotRemoveControlException(String, String, Exception)	基礎架構。

回頁首

屬性

	名稱	說明
	Data	取得由索引鍵/值組所組成的集合，提供關於此例外狀況的額外使用者定義資訊。 (繼承自 Exception)。
	HelpLink	取得或設定與這個例外狀況相關聯說明檔的連結。 (繼承自 Exception)。
	HResult	取得或設定 HRESULT，它是指派給特定例外狀況的編碼數值。 (繼承自 Exception)。
	InnerException	取得造成目前例外狀況的 Exception 執行個體。 (繼承自 Exception)。
	Message	取得描述目前例外狀況的訊息。 (繼承自 Exception)。
	Source	取得或設定造成錯誤的應用程式或物件的名稱。 (繼承自 Exception)。
	StackTrace	取得呼叫堆疊上之立即框架的字串表示。 (繼承自 Exception)。
	TargetSite	取得擲回目前例外狀況的方法。 (繼承自 Exception)。

回頁首

方法

	名稱	說明
	Equals	判斷指定的 Object 和目前的 Object 是否相等。 (繼承自 Object)。
	Finalize	允許物件在記憶體回收進行回收之前，嘗試釋放資源並執行其他清除作業。 (繼承自 Object)。
	GetBaseException	在衍生類別中覆寫時，傳回一個或多個後續的例外狀況的根本原因 Exception。 (繼承自 Exception)。
	GetHashCode	做為特定型別的雜湊函式。 (繼承自 Object)。
	GetObjectData	在衍生類別中覆寫時，使用例外狀況的資訊設定 SerializationInfo。 (繼承自 Exception)。
	GetType	取得目前執行個體的執行階段型別。 (繼承自 Exception)。
	MemberwiseClone	建立目前 Object 的淺層複本 (Shallow Copy)。 (繼承自 Object)。
	ToString	建立並傳回目前例外狀況的字串表示。 (繼承自 Exception)。

回頁首

備註

如果您在設計階段將主控制項和 Windows Form 控制項加入至屬於文件層級自訂之一部分的文件中，則無法在執行階段刪除這些控制項。 如需詳細資訊，請參閱在執行階段將控制項加入至 Office 文件。

如果您呼叫下列其中一個方法來刪除在設計階段加入的控制項，Visual Studio Tools for Office Runtime 會擲回這個例外狀況：

• 在 Microsoft Office Excel 的文件層級自訂中，Microsoft.Office.Tools.Excel.ControlCollection 物件的 Remove 方法。

• 在 Microsoft Office Word 的文件層級自訂中，Microsoft.Office.Tools.Word.ControlCollection 物件的 Remove 方法。

• 在 Word 文件或 Excel 活頁簿上，主控制項或 Windows Form 控制項的 Delete 方法。

執行緒安全

這個型別的任何 Public static (在 Visual Basic 中為 Shared) 成員都具備執行緒安全。並非所有的執行個體成員都是安全執行緒。

請參閱

參考

Microsoft.Office.Tools 命名空間

其他資源

在執行階段將控制項加入至 Office 文件