Compartir a través de

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

  • Artículo

Actualización: noviembre 2007

Nota

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.

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

Tipo de proyecto

  • Proyectos de nivel de documento

  • Proyectos de nivel de aplicación

Versión de Microsoft Office

  • Microsoft Office System 2007

Un manifiesto de aplicación de una solución de Visual Studio Tools para Office es un archivo XML que describe los ensamblados cargados en una solución de Microsoft Office.

Visual Studio Tools para Office usa el esquema del manifiesto de aplicación ClickOnce definido en la referencia del Manifiesto de aplicación ClickOnce.

Los manifiestos de aplicación de Visual Studio Tools para Office usan los siguientes elementos y atributos de ClickOnce.

Elemento

Descripción

Atributos

<assembly> (Elemento) [Aplicación ClickOnce]

Necesario. Elemento de nivel superior.

manifestVersion

Elemento <assemblyIdentity> (Aplicación ClickOnce)

Necesario. Identifica el ensamblado primario de la aplicación ClickOnce.

name

version

publicKeyToken

processorArchitecture

language

<trustInfo> (Elemento) [Aplicación ClickOnce]

Identifica los requisitos de seguridad de la aplicación.

Ninguna

Elemento <entryPoint> (Aplicación ClickOnce)

Obligatorio. Identifica el punto de entrada del código de aplicación para la ejecución.

name

dependencyName

customHostSpecified

Elemento <dependency> (Aplicación ClickOnce)

Necesario. Identifica cada dependencia necesaria para que se ejecute la aplicación. Identifica opcionalmente ensamblados que necesitan preinstalarse.

Ninguno

Elemento <file> (Aplicación ClickOnce)

Necesario. Identifica cada archivo de no ensamblado utilizado por la aplicación. Puede incluir los datos de aislamiento Componente Modelo de objetos (COM) asociados al archivo.

name

size

Los manifiestos de aplicación de Visual Studio Tools para Officetienen el elemento siguiente en el espacio de nombres co.v1.

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint>

Los manifiestos de aplicación de Visual Studio Tools para Office también tienen los elementos y atributos siguientes en el espacio de nombres vstav2.

<addIn>
    <entryPoints>
        <entryPoint>
        </entryPoint>
    </entryPoints>
    <update></update>
    <application>
        <customization>
        </customization>
    </application
</addIn>

Elemento

Descripción

Atributos

<customHostSpecified> (Elemento)

Necesario. Marca específicamente el manifiesto como una solución de Office.

Ninguno

<addin> (Elemento, 2007 System)

Necesario. Almacena los puntos de entrada en un espacio de nombres único.

Ninguno

<entryPoints> (Elemento, 2007 System)

Necesario. Agrupa todos los ensamblados que se van a ejecutar.

Ninguno

<entryPoint> (Elemento, 2007 System)

Necesario. Identifica el ensamblado que se va a ejecutar.

class

contract

<update> (Elemento, 2007 System)

Necesario. Configura las actualizaciones para la solución.

enabled

expiration

<application> (Elemento, 2007 System)

Necesario. Ajusta la información específica de la aplicación en un nodo único.

Ninguno

<customization> (Elemento, 2007 System)

Necesario. Almacena la información específica de la aplicación host en un espacio de nombres independiente.

xmlns

<document> (Elemento, 2007 System)

Sólo es necesario para las soluciones de nivel de documento. Almacena la información específica de la personalización.

solutionId

<appAddin> (Elemento, 2007 System)

Sólo es necesario para las soluciones de nivel de aplicación. Almacena la información específica de la personalización.

application

loadBehavior

keyName

<friendlyName> (Elemento, 2007 System)

Opcional. Almacena el nombre del complemento que aparece en la lista de complementos instalados.

Ninguno

<description> (Elemento, 2007 System)

Sólo es necesario para los complementos de nivel de aplicación. Almacena la descripción que aparece en la lista de programas instalados.

Ninguno

<formRegions> (Elemento, 2007 System)

Sólo se requiere para complementos de Outlook 2007 que incluyen áreas de formulario.

Ninguno

<formRegion> (Elemento, 2007 System)

Sólo se requiere para complementos de Outlook 2007 que incluyen áreas de formulario.

name

Comentarios

Puede editar manualmente los manifiestos de aplicación e implementación en las soluciones de Visual Studio Tools para Office. La herramienta de generación y edición de manifiestos (mage.exe y mageui.exe) debe volver a firmar los manifiestos de aplicación e implementación una vez que se editen los manifiestos. Firme primero el manifiesto de aplicación y, a continuación, el manifiesto de implementación. Para obtener más información, vea Herramienta de generación y edición de manifiestos (Mage.exe) y Herramienta de generación y edición de manifiestos, cliente gráfico (MageUI.exe).

Ubicación del archivo

Cada manifiesto de aplicación es específico para una única versión de una solución. Por esta razón, los manifiestos de aplicación se deben almacenar de forma independiente con respecto a los manifiestos de implementación. Visual Studio coloca los archivos específicos de la versión en un subdirectorio con el nombre de la versión asociada en el subdirectorio Archivos de aplicación en la carpeta de publicación.

Sintaxis de los nombres de archivo

El nombre de un archivo de manifiesto de aplicación debe ser el nombre completo y la extensión de la aplicación, tal y como se identifica en el elemento assemblyIdentity, seguido de la extensión .manifest. Por ejemplo, un manifiesto de aplicación que hace referencia a la personalización OutlookAddIn1.dll usaría la sintaxis de nombre de archivo siguiente.

OutlookAddIn1.dll.manifest

ExcelWorkbook1.dll.manifest

Ejemplo de personalización de nivel de documento

Descripción

En el ejemplo de código siguiente se muestran las secciones de un manifiesto de aplicación específicas de una solución de Visual Studio Tools para Office. Ésta es una personalización de nivel de documento de Microsoft Office Excel 2007.

Código

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
    <vstav2:entryPoints>
        <vstav2:entryPoint class="ExcelWorkbook1.ThisWorkbook">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet1">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet2">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
        <vstav2:entryPoint class="ExcelWorkbook1.Sheet3">
            <assemblyIdentity
                name="ExcelWorkbook1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
    </vstav2:entryPoints>
    <vstav2:update enabled="true">
        <vstav2:expiration maximumAge="7" unit="days" />
    </vstav2:update>
    <vstav2:application>
        <vstov3:customization
            xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
        <vstov3:document
            solutionId="989..." />
        </vstov3:customization>
    </vstav2:application>
</vstav2:addIn>

Ejemplo de complemento de nivel de aplicación

Descripción

En el ejemplo de código siguiente se muestran las secciones de un manifiesto de aplicación específicas de una solución de Visual Studio Tools para Office. Éste es un complemento de nivel de aplicación de Microsoft Office Outlook 2007 que incluye un área de formulario.

Código

<entryPoint>
    <co.v1:customHostSpecified />
</entryPoint> 
[...]
<vstav2:addIn xmlns:vstav2="urn:schemas-microsoft-com:vsta.v2">
    <vstav2:entryPoints>
        <vstav2:entryPoint class="OutlookAddIn1.ThisAddIn">
            <assemblyIdentity
                name="OutlookAddIn1"
                version="1.0.0.0"
                language="neutral"
                processorArchitecture="msil" />
        </vstav2:entryPoint>
    </vstav2:entryPoints>
    <vstav2:update enabled="true">
        <vstav2:expiration maximumAge="7" unit="days" />
    </vstav2:update>
    <vstav2:application>
        <vstov3:customization
            xmlns:vstov3="urn:schemas-microsoft-com:vsto.v3">
            <vstov3:appAddIn
                application="Outlook"
                loadBehavior="3"
                keyName="OutlookAddIn1">
                <vstov3:friendlyName>
                    OutlookAddIn1
                </vstov3:friendlyName>
                <vstov3:description>
                    OutlookAddIn1 - Outlook add-in created with 
                    Visual Studio Tools for Office
                </vstov3:description>
                <vstov3:formRegions>
                    <vstov3:formRegion
                        name="OutlookAddIn1.FormRegion1">
                        <vstov3:messageClass name="IPM.Note" />
                        <vstov3:messageClass name="IPM.Contact" />
                        <vstov3:messageClass name="IPM.Appointment" />
                    </vstov3:formRegion>
                </vstov3:formRegions>
            </vstov3:appAddIn>
        </vstov3:customization>
    </vstav2:application>
</vstav2:addIn>

Vea también

Referencia

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

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

Manifiesto de aplicación ClickOnce