CannotRemoveControlException 类

当代码尝试移除在设计时添加到文档中的宿主控件或 Windows 窗体控件时引发的异常。

继承层次结构

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。）
	GetBaseException	当在派生类中重写时，返回 Exception，它是一个或多个并发的异常的根源。 （继承自 Exception。）
	GetHashCode	用作特定类型的哈希函数。 （继承自 Object。）
	GetObjectData	安全关键。当在派生类中重写时，用关于异常的信息设置 SerializationInfo。 （继承自 Exception。）
	GetType	获取当前实例的运行时类型。 （继承自 Exception。）
	ToString	创建并返回当前异常的字符串表示形式。 （继承自 Exception。）

页首

备注

如果设计时在文档中添加宿主控件和 Windows 窗体控件作为文档级自定义项的一部分，则无法在运行时删除这些控件。 有关更多信息，请参见在运行时向 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 窗体控件的 Delete 方法。

线程安全

此类型的任何公共 static（在 Visual Basic 中为 Shared） 成员都是线程安全的。但不保证所有实例成员都是线程安全的。

请参见

参考

Microsoft.Office.Tools 命名空间

其他资源

在运行时向 Office 文档添加控件