Metodo CustomTaskPaneCollection.Remove
Rimuove l'oggetto CustomTaskPane specificato dall'oggetto CustomTaskPaneCollection.
Spazio dei nomi: Microsoft.Office.Tools
Assembly: Microsoft.Office.Tools.Common (in Microsoft.Office.Tools.Common.dll)
Sintassi
'Dichiarazione
Function Remove ( _
customTaskPane As CustomTaskPane _
) As Boolean
bool Remove(
CustomTaskPane customTaskPane
)
Parametri
- customTaskPane
Tipo: Microsoft.Office.Tools.CustomTaskPane
Oggetto CustomTaskPane da rimuovere dalla raccolta.
Valore restituito
Tipo: System.Boolean
true se l'oggetto CustomTaskPane è stato rimosso dall'insieme, false se l'insieme non contiene l'oggetto CustomTaskPane specificato.
Eccezioni
Eccezione | Condizione |
---|---|
ArgumentNullException | customTaskPane è nullriferimento null (Nothing in Visual Basic). |
ObjectDisposedException | Il metodo Dispose() è già stato chiamato nella classe CustomTaskPaneCollection. |
Note
Se il componente aggiuntivo non richiede più un riquadro attività personalizzato, è possibile utilizzare il metodo Remove per liberare le risorse utilizzate dal riquadro attività mentre il componente aggiuntivo è ancora in esecuzione. In tal caso, il metodo Dispose() dell'oggetto CustomTaskPane specificato viene chiamato automaticamente.
In Runtime di Visual Studio Tools per Office viene effettuata la pulizia automatica delle risorse utilizzate dal riquadro attività personalizzato quando il componente aggiuntivo viene scaricato. Non chiamare il metodo Remove nel gestore eventi ThisAddIn_Shutdown del progetto. Questo metodo genera un'eccezione ObjectDisposedException, perché in Runtime di Visual Studio Tools per Office viene effettuata la pulizia delle risorse utilizzate dall'oggetto CustomTaskPane prima della chiamata a ThisAddIn_Shutdown.
Sicurezza di .NET Framework
- Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.