CustomTaskPaneCollection.Remove (Método)
Quita el CustomTaskPane especificado de CustomTaskPaneCollection.
Espacio de nombres: Microsoft.Office.Tools
Ensamblado: Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)
Sintaxis
'Declaración
Function Remove ( _
customTaskPane As CustomTaskPane _
) As Boolean
bool Remove(
CustomTaskPane customTaskPane
)
Parámetros
- customTaskPane
Tipo: Microsoft.Office.Tools.CustomTaskPane
CustomTaskPane que se va a quitar de la colección.
Valor devuelto
Tipo: System.Boolean
true si CustomTaskPane se quitó correctamente de la colección; false si la colección no contiene el CustomTaskPane especificado.
Excepciones
Excepción | Condición |
---|---|
ArgumentNullException | El valor de customTaskPane es nullreferencia null (Nothing en Visual Basic). |
ObjectDisposedException | Ya se ha llamado al método Dispose() en CustomTaskPaneCollection. |
Comentarios
Si su complemento ya no necesita un panel de tareas personalizado, puede utilizar el método Remove para limpiar los recursos que utiliza el panel de tareas mientras el complemento aún está en ejecución. Cuando se utiliza este método, se llama automáticamente al método Dispose() del objeto CustomTaskPane especificado.
Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office limpia automáticamente los recursos que usa el panel de tareas cuando se descarga el complemento. No llame al método Remove del controlador de eventos ThisAddIn_Shutdown del proyecto. Este método iniciará una excepción ObjectDisposedException, ya que Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office limpia los recursos que usa el objeto CustomTaskPane antes de que se llame a ThisAddIn_Shutdown.
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.