Compartir a través de

Cómo: Actualizar rutas de acceso a ensamblados de manifiestos de aplicaciones mediante programación (2003 System)

  • Artículo

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.

Puede utilizar el modelo de objetos en el motor en tiempo de ejecución de Visual Studio Tools para Office para actualizar mediante programación el manifiesto de aplicación que está incrustado en un documento que forma parte de una personalización de nivel de documento.

Cuando cambie las rutas de acceso a los ensamblados, debe crear un nuevo manifiesto de aplicación y reemplazar el que tiene las rutas de acceso antiguas. Puede utilizar variables de entorno, como %ProgramFiles% o %UserProfile%, en las rutas de acceso de los ensamblados.

Debe colocar el código para manipular el modelo de objetos en un nuevo proyecto (no en la solución de Visual Studio Tools para Office) como una aplicación de consola o un proyecto de Windows Forms. Visual Studio Tools para Office incluye un ejemplo que muestra cómo crear una herramienta que se puede utilizar para editar el manifiesto de aplicación incrustado. Para obtener más información, vea Ejemplo ServerDocument.

Existe otro modelo de actualización de manifiestos que implica la modificación de archivos XML en un servidor. Para obtener más información, vea Cómo: Cambiar la ubicación de las personalizaciones de nivel de documento (2003 System).

Nota:

Este tema no se aplica a los complementos de nivel de aplicación, porque no utilizan manifiestos de aplicación incrustados. Para cambiar la ruta de acceso al ensamblado de complemento, utilice un editor de texto para actualizar el manifiesto de aplicación que está en el equipo cliente. Para obtener más información, vea Manifiestos de aplicación para soluciones de Office (2003 System). Para obtener más información sobre las personalizaciones de nivel de documento y los complementos de nivel de aplicación, vea Arquitectura de las personalizaciones de nivel de documento.

Para cambiar la ruta de acceso a los ensamblados mediante programación

  1. Agregue una referencia a Microsoft.VisualStudio.Tools.Office.Runtime.v9.0 a su proyecto de manipulación de modelo de objetos si todavía no tiene ninguna.

  2. Agregue a la parte superior del archivo de código una instrucción Imports o using para el tiempo de ejecución.

    Imports Microsoft.VisualStudio.Tools.Applications.Runtime

    using Microsoft.VisualStudio.Tools.Applications.Runtime;

  3. Llame al método estático AddCustomization de la clase ServerDocument y pase los argumentos necesarios. Primero debe llamar al método RemoveCustomization para quitar del documento las personalizaciones de Visual Studio Tools para Office existentes, o AddCustomization producirá una excepción InvalidOperationException.

    Dim solutionDocument As String = "C:\Documents\ExcelApplication.xls"
Dim assemblyName As String = "ExcelApplication.dll"
Dim manifestPath As String = "\\serversame\deployshare\ExcelApplication.application"
Dim applicationVersion As String = "1.0.0.1"

If ServerDocument.IsCustomized(solutionDocument) Then
    ServerDocument.RemoveCustomization(solutionDocument)
End If

ServerDocument.AddCustomization( _
    solutionDocument, assemblyName, manifestPath, _
    applicationVersion, False)

    string solutionDocument = @"C:\Documents\ExcelApplication.xls";
string assemblyName = "ExcelApplication.dll";
string manifestPath = @"\\servername\deployshare\ExcelApplication.application";
string applicationVersion = "1.0.0.1";

if (ServerDocument.IsCustomized(solutionDocument))
{
    ServerDocument.RemoveCustomization(solutionDocument);
}

ServerDocument.AddCustomization(
    solutionDocument, assemblyName, manifestPath, 
    applicationVersion, false);

Vea también

Tareas

Cómo: Cambiar la ruta de acceso al manifiesto de implementación mediante programación (2003 System)

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

Conceptos

Manifiestos de implementación y aplicación en soluciones de Office

Implementar soluciones de Office (2003 System)

Referencia

Manifiestos de aplicación para soluciones de Office (2003 System)

Manifiestos de implementación para soluciones de Office (2003 System)