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 Do usunięcia z kolekcji.
Wartość zwracana
Typ: System.Boolean
true Jeśli CustomTaskPane została pomyślnie usunięta z kolekcji; falseJeśli kolekcja zawiera określony CustomTaskPane.
Wyjątki
| Wyjątek | Warunek |
|---|---|
| ArgumentNullException | customTaskPaneis nullodwołanie o wartości null (Nothing w języku Visual Basic). |
| ObjectDisposedException | Dispose Metoda została już wywołana dla CustomTaskPaneCollection. |
Uwagi
Jeśli dodatek nie wymaga już niestandardowe okienko zadań, można użyć Remove metoda oczyścić zasoby używane przez okienko zadań, podczas gdy nadal jest uruchomiony dodatek.Przy użyciu tej metody, Dispose metody określonej 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 metodę w ThisAddIn_Shutdown obsługi zdarzeń w projekcie.Ta metoda spowoduje zgłoszenie ObjectDisposedException, bo Visual Studio 2010 Tools for Office Runtime czyści zasoby używane przez CustomTaskPane obiekt przed ThisAddIn_Shutdown nosi nazwę.
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 Przy użyciu bibliotek z częściowo zaufanego kodu..