CannotRemoveControlException-Klasse

Die Ausnahme, die ausgelöst wird, wenn Code versucht, ein Hoststeuerelement oder Windows Forms-Steuerelement zu entfernen, das einem Dokument zur Entwurfszeit hinzugefügt wurde.

Vererbungshierarchie

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

Namespace:  Microsoft.Office.Tools
Assembly:  Microsoft.Office.Tools.v4.0.Framework (in Microsoft.Office.Tools.v4.0.Framework.dll)

Syntax

'Declaration
<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

Der CannotRemoveControlException-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	CannotRemoveControlException()	Infrastruktur.
	CannotRemoveControlException(Exception)	Infrastruktur.
	CannotRemoveControlException(String)	Infrastruktur.
	CannotRemoveControlException(String, Exception)	Infrastruktur.
	CannotRemoveControlException(String, String)	Infrastruktur.
	CannotRemoveControlException(String, String, Exception)	Infrastruktur.

Zum Seitenanfang

Eigenschaften

	Name	Beschreibung
	Data	Ruft eine Auflistung von Schlüssel-Wert-Paaren ab, die zusätzliche benutzerdefinierte Informationen zu der Ausnahme bereitstellen. (Von Exception geerbt.)
	HelpLink	Ruft einen Link zur Hilfedatei ab, die dieser Ausnahme zugeordnet ist, oder legt einen Link fest. (Von Exception geerbt.)
	HResult	Ruft HRESULT ab oder legt HRESULT fest. Dies ist ein codierter Wert, der einer bestimmten Ausnahme zugeordnet ist. (Von Exception geerbt.)
	InnerException	Ruft die Exception-Instanz ab, die die aktuelle Ausnahme verursachte. (Von Exception geerbt.)
	Message	Ruft eine Meldung ab, die die aktuelle Ausnahme beschreibt. (Von Exception geerbt.)
	Source	Gibt den Namen der Anwendung oder des Objekts zurück, das den Fehler verursacht hat, oder legt diesen fest. (Von Exception geerbt.)
	StackTrace	Ruft eine Zeichenfolgendarstellung der unmittelbaren Frames in der Aufrufliste ab. (Von Exception geerbt.)
	TargetSite	Ruft die Methode ab, die die aktuelle Ausnahme auslöst. (Von Exception geerbt.)

Zum Seitenanfang

Methoden

	Name	Beschreibung
	Equals	Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist. (Von Object geerbt.)
	GetBaseException	Gibt beim Überschreiben in einer abgeleiteten Klasse eine Exception zurück, die die ursprüngliche Ursache für eine oder mehrere nachfolgende Ausnahmen ist. (Von Exception geerbt.)
	GetHashCode	Fungiert als Hashfunktion für einen bestimmten Typ. (Von Object geerbt.)
	GetObjectData	Sicherheitsrelevant. Legt beim Überschreiben in einer abgeleiteten Klasse die SerializationInfo mit Informationen über die Ausnahme fest. (Von Exception geerbt.)
	GetType	Ruft den Laufzeittyp der aktuellen Instanz ab. (Von Exception geerbt.)
	ToString	Erstellt eine Zeichenfolgenentsprechung der aktuellen Ausnahme und gibt diese zurück. (Von Exception geerbt.)

Zum Seitenanfang

Hinweise

Wenn Sie Dokumenten, die Teil von Anpassungen auf Dokumentebene sind, Hoststeuerelemente und Windows Forms-Steuerelemente zur Entwurfszeit hinzufügen, können Sie diese Steuerelemente zur Laufzeit nicht löschen.Weitere Informationen hierzu finden Sie unter Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit.

Diese Ausnahme kann von der Visual Studio-Tools für Office-Laufzeit ausgelöst werden, wenn Sie eine der folgenden Methoden zum Löschen eines Steuerelements aufrufen, das zur Entwurfszeit hinzugefügt wurde:

• Die Remove-Methode eines Microsoft.Office.Tools.Excel.ControlCollection-Objekts in einer Anpassung auf Dokumentebene für Microsoft Office Excel.

• Die Remove-Methode eines Microsoft.Office.Tools.Word.ControlCollection-Objekts in einer Anpassung auf Dokumentebene für Microsoft Office Word.

• Die Delete-Methode eines Hoststeuerelements bzw. eines Windows Forms-Steuerelements in einem Word-Dokument bzw. einer Excel-Arbeitsmappe.

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.

Siehe auch

Referenz

Microsoft.Office.Tools-Namespace

Weitere Ressourcen

Hinzufügen von Steuerelementen zu Office-Dokumenten zur Laufzeit