CustomTaskPaneCollection.Remove-Methode (2007 System)
Aktualisiert: November 2007
Entfernt den angegebenen CustomTaskPane aus der CustomTaskPaneCollection.
Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)
Syntax
'Declaration
Public Function Remove ( _
customTaskPane As CustomTaskPane _
) As Boolean
'Usage
Dim instance As CustomTaskPaneCollection
Dim customTaskPane As CustomTaskPane
Dim returnValue As Boolean
returnValue = instance.Remove(customTaskPane)
public bool Remove(
CustomTaskPane customTaskPane
)
Parameter
customTaskPane
Typ: Microsoft.Office.Tools.CustomTaskPaneDer aus der Auflistung zu entfernende CustomTaskPane.
Rückgabewert
Typ: System.Boolean
true , wenn der CustomTaskPane erfolgreich aus der Auflistung entfernt wurde, und false, wenn die Auflistung den angegebenen CustomTaskPane nicht enthält.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| ArgumentNullException | customTaskPane ist nullNULL-Verweis (Nothing in Visual Basic). |
| ObjectDisposedException | Die Dispose-Methode wurde bereits für die CustomTaskPaneCollection aufgerufen. |
Hinweise
Wenn das Add-In keinen benutzerdefinierten Aufgabenbereich mehr benötigt, können Sie die Remove-Methode verwenden, um vom Aufgabenbereich verwendete Ressourcen zu bereinigen, während das Add-In noch ausgeführt wird. Wenn Sie diese Methode verwenden, wird die Dispose-Methode des angegebenen CustomTaskPane-Objekts automatisch aufgerufen.
Die Visual Studio Tools for Office-Laufzeit bereinigt automatisch Ressourcen, die vom benutzerdefinierten Aufgabenbereich verwendet werden, wenn das Add-In entladen wird. Rufen Sie die Remove-Methode im ThisAddIn_Shutdown-Ereignishandler des Projekts nicht auf. Diese Methode führt zu einer ObjectDisposedException, da die Visual Studio Tools for Office-Laufzeit Ressourcen bereinigt, die vom CustomTaskPane-Objekt verwendet werden, bevor ThisAddIn_Shutdown aufgerufen wird.
Berechtigungen
- Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.
Siehe auch
Referenz
CustomTaskPaneCollection-Klasse