Cómo: Quitar extensiones de código administrado de documentos (2003 System)

Artículo
04/28/2010

Actualización: noviembre 2007

Se aplica a
La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office. Tipo de proyecto Proyectos de nivel de documento Versión de Microsoft Office Microsoft Office 2003 Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

La información de este tema sólo se aplica a los proyectos y versiones especificados de Visual Studio Tools para Office de Microsoft Office.

Tipo de proyecto

Proyectos de nivel de documento

Versión de Microsoft Office

Microsoft Office 2003

Para obtener más información, vea Características disponibles por aplicación y tipo de proyecto.

Puede quitar mediante programación el ensamblado de personalización de Visual Studio Tools para Office de un documento o libro que forma parte de una personalización de nivel de documento para Microsoft Office 2003. Los usuarios pueden abrir los documentos y ver el contenido, pero cualquier interfaz de usuario personalizada que agregue no aparecerá y el código no se ejecutará. Cuando quite el ensamblado, puede optar por dejar los datos almacenados en caché en el documento o quitarlos:

Si desea mantener los datos almacenados en caché, borre el manifiesto de aplicación que está incrustado en el documento. Quizás desee mantener los datos almacenados en caché si los va a leer posteriormente una página ASP.NET o una aplicación del servidor.
Si ya no necesita los datos almacenados en caché, borre el manifiesto de aplicación y los datos almacenados en caché.

El tiempo de ejecución de Visual Studio Tools para Office incluye un modelo de objetos que permite realizar estas acciones mediante programación.

Borrar el manifiesto de aplicación incrustado

Utilice la clase ServerDocument para borrar sólo el manifiesto de aplicación incrustado. Se debe colocar el código que utiliza la clase ServerDocument en un nuevo proyecto (no la solución de Visual Studio Tools para Office), por ejemplo, en una aplicación de consola o en un proyecto de formularios Windows Forms.

Para borrar el manifiesto de aplicación incrustado

Cree un nuevo proyecto, por ejemplo, una aplicación de consola o un proyecto de formularios Windows Forms.
Agregue al proyecto una referencia al ensamblado Microsoft.VisualStudio.Tools.Applications.Runtime.dll.

Agregue la siguiente instrucción Imports o using al principio del archivo de código.

Imports Microsoft.VisualStudio.Tools.Applications.Runtime

using Microsoft.VisualStudio.Tools.Applications.Runtime;

Cree una instancia de ServerDocument y pase el documento de la solución. Llame al método Clear de la propiedad AppManifest.

Dim sd As ServerDocument = Nothing
Try
    sd = New ServerDocument("C:\Documents\SolutionDocument.doc")
    sd.AppManifest.Clear()

ServerDocument sd = null;
try 
{
    sd = new ServerDocument(@"C:\Documents\SolutionDocument.doc");
    sd.AppManifest.Clear();

Guarde los cambios y cierre el documento.

    sd.Save()

Finally
    If Not sd Is Nothing Then
        sd.Close()
    End If
End Try

    sd.Save();
}
finally
{
    if (sd != null)
    {
        sd.Close();
    }
}

Borrar el manifiesto de la aplicación incrustado y los datos almacenados en caché

Puede borrar el manifiesto de la aplicación incrustado y los datos almacenados en caché del documento mediante uno de los métodos RemoveCustomization:

Para un documento abierto en un equipo cliente, utilice el método Document.RemoveCustomization o Workbook.RemoveCustomization.
Para un documento cerrado o un documento en un servidor, utilice el método ServerDocument.RemoveCustomization.

Nota:
Los métodos Document.RemoveCustomization y Workbook.RemoveCustomization también quitan el Control de almacenamiento en tiempo de ejecución del documento. Para obtener más información sobre el Control de almacenamiento en tiempo de ejecución, vea Información general acerca del control de almacenamiento del motor en tiempo de ejecución.

Para borrar el manifiesto de aplicación incrustado y los datos almacenados en caché de un documento abierto en un equipo cliente

En el proyecto de nivel de documento de Microsoft Office Word o Microsoft Office Excel que corresponda, llame al método Document.RemoveCustomization (para Word) o Workbook.RemoveCustomization (para Excel).

Para borrar el manifiesto de aplicación incrustado y los datos almacenados en caché de un documento cerrado o un documento en un servidor

Cree un nuevo proyecto, por ejemplo, una aplicación de consola o un proyecto de formularios Windows Forms.
Agregue al proyecto una referencia al ensamblado Microsoft.VisualStudio.Tools.Applications.Runtime.dll.

Agregue la siguiente instrucción Imports o using al principio del archivo de código.

Imports Microsoft.VisualStudio.Tools.Applications.Runtime

using Microsoft.VisualStudio.Tools.Applications.Runtime;

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

If (ServerDocument.IsCustomized("C:\Documents\SolutionDocument.doc")) Then

    ServerDocument.RemoveCustomization("C:\Documents\SolutionDocument.doc")
End If

if (ServerDocument.IsCustomized(@"C:\Documents\SolutionDocument.doc"))
{
    ServerDocument.RemoveCustomization(@"C:\Documents\SolutionDocument.doc");
}