CustomTaskPaneCollection.Remove-Methode
Entfernt den angegebenen CustomTaskPane aus der CustomTaskPaneCollection.
Namespace: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Syntax
'Declaration
Function Remove ( _
customTaskPane As CustomTaskPane _
) As Boolean
bool Remove(
CustomTaskPane customTaskPane
)
Parameter
- customTaskPane
Typ: Microsoft.Office.Tools.CustomTaskPane
Der 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 hat den Wert 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 löst eine ObjectDisposedException aus, da die Visual Studio Tools for Office-Laufzeit Ressourcen bereinigt, die vom CustomTaskPane-Objekt verwendet werden, bevor ThisAddIn_Shutdown aufgerufen wird.
.NET Framework-Sicherheit
- 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.