Metoda CustomTaskPaneCollection.Remove —
Usuwa określony CustomTaskPane z CustomTaskPaneCollection.
Przestrzeń nazw: Microsoft.Office.Tools
Zestaw: Microsoft.Office.Tools.Common (w Microsoft.Office.Tools.Common.dll)
Składnia
'Deklaracja
Function Remove ( _
customTaskPane As CustomTaskPane _
) As Boolean
bool Remove(
CustomTaskPane customTaskPane
)
Parametry
- customTaskPane
Typ: Microsoft.Office.Tools.CustomTaskPane
CustomTaskPane Usunąć z kolekcji.
Wartość zwracana
Typ: System.Boolean
true Jeśli CustomTaskPane został pomyślnie usunięty z kolekcji; falseJeśli kolekcja zawiera określony CustomTaskPane.
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | customTaskPane wynosi nullodwołanie o wartości null (Nothing w języku Visual Basic). |
| ObjectDisposedException | Dispose Została już wywołana metoda na CustomTaskPaneCollection. |
Uwagi
Jeśli dodatek nie wymaga już niestandardowe okienko zadań, można użyć Remove metoda, aby oczyścić zasoby używane przez okienko zadań, podczas gdy nadal jest uruchomiony dodatek.Korzystając z tej metody, Dispose określona metoda CustomTaskPane obiektu nazywa się automatycznie.
Visual Studio 2010 Tools for Office Runtime Automatycznie oczyszcza zasoby używane przez niestandardowe okienko zadań, gdy dodatek jest zwalniana.Nie wywołuj Remove metoda w ThisAddIn_Shutdown obsługi zdarzeń w projekcie.Ta metoda spowoduje zgłoszenie ObjectDisposedException, bo Visual Studio 2010 Tools for Office Runtime , które utraciły zasoby używane przez CustomTaskPane obiekt przed ThisAddIn_Shutdown nazywa się.
Zabezpieczenia programu .NET Framework
- Pełne zaufanie do bezpośredniego wywołującego. Tego elementu członkowskiego nie można używać w kodzie częściowo zaufanym. Aby uzyskać więcej informacji, zobacz Używanie bibliotek pochodzących z częściowo zaufanego kodu.