Compartir a través de

Eliminación de extensiones de código administrado de documentos

  • Artículo

Puede quitar mediante programación el ensamblado de personalización de un documento o libro que forma parte de una personalización de nivel de documento para Microsoft Office Word o Microsoft Office Excel. A continuación, los usuarios pueden abrir los documentos y ver el contenido, pero no aparecerá ninguna interfaz de usuario (UI) personalizada que agregue a los documentos y el código no se ejecutará.

Se aplica a: la información de este tema se aplica a proyectos de nivel de documento para Excel y Word. Para obtener más información, consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

Puede quitar el ensamblado de personalización mediante uno de los RemoveCustomization métodos proporcionados por el entorno de ejecución de Visual Studio Tools para Office . El método que use depende de si desea quitar la personalización en tiempo de ejecución (es decir, ejecutando código en la personalización mientras el documento de Word o el libro de Excel está abierto), o si desea quitar la personalización de un documento cerrado o un documento que esté en un servidor que no tenga Instalado Microsoft Office.

Para quitar el ensamblado de personalización en tiempo de ejecución

  1. En el código de personalización, llame al RemoveCustomization método (para Word) o al RemoveCustomization método (para Excel). Solo se debe llamar a este método después de que ya no se necesite la personalización.

    La ubicación en la que se llama a este método en el código depende de cómo se use la personalización. Por ejemplo, si los clientes usan las características de la personalización hasta que estén listos para enviar el documento a otros clientes que solo necesiten el propio documento (no la personalización), puede proporcionar alguna interfaz de usuario que llame RemoveCustomization cuando el cliente haga clic en él. Como alternativa, si la personalización rellena el documento con datos cuando se abre por primera vez, pero la personalización no proporciona ninguna otra característica a la que acceden directamente los clientes, puede llamar a RemoveCustomization tan pronto como la personalización termine de inicializar el documento.

Para quitar el ensamblado de personalización de un documento cerrado o un documento en un servidor

  1. En un proyecto que no requiere Microsoft Office, como una aplicación de consola o un proyecto de Windows Forms, agregue una referencia al ensamblado Microsoft.VisualStudio.Tools.Applications.ServerDocument.dll .

  2. Agregue la siguiente instrucción Imports o using a la parte superior del archivo de código.

    using Microsoft.VisualStudio.Tools.Applications;

  3. Llame al método estático RemoveCustomization de la ServerDocument clase y especifique la ruta de acceso del documento de solución para el parámetro .

    En el ejemplo de código siguiente se supone que va a quitar la personalización de un documento denominado WordDocument1.docx que está en el escritorio.

    string documentPath = System.Environment.GetFolderPath(
    Environment.SpecialFolder.Desktop) + @"\WordDocument1.docx";
int runtimeVersion = 0;

try
{
    runtimeVersion = ServerDocument.GetCustomizationVersion(documentPath);

    if (runtimeVersion == 3)
    {
        ServerDocument.RemoveCustomization(documentPath);
        System.Windows.Forms.MessageBox.Show("The customization has been removed.");
    }
}
catch (FileNotFoundException)
{
    System.Windows.Forms.MessageBox.Show("The specified document does not exist.");
}
catch (IOException)
{
    System.Windows.Forms.MessageBox.Show("The specified document is read-only.");
}
catch (InvalidOperationException ex)
{
    System.Windows.Forms.MessageBox.Show("The customization could not be removed.\n" +
        ex.Message);
}

  4. Compile el proyecto y ejecute la aplicación en el equipo donde desea quitar la personalización. El equipo debe tener instalado el entorno de ejecución de Visual Studio 2010 Tools para Office.

Contenido relacionado