Manifiestos de aplicación para soluciones de Office (2007 System)
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
Versión de Microsoft Office
|
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 |
|---|---|---|
Necesario. Elemento de nivel superior. |
manifestVersion |
|
Necesario. Identifica el ensamblado primario de la aplicación ClickOnce. |
name version publicKeyToken processorArchitecture language |
|
Identifica los requisitos de seguridad de la aplicación. |
Ninguna |
|
Obligatorio. Identifica el punto de entrada del código de aplicación para la ejecución. |
name dependencyName customHostSpecified |
|
Necesario. Identifica cada dependencia necesaria para que se ejecute la aplicación. Identifica opcionalmente ensamblados que necesitan preinstalarse. |
Ninguno |
|
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 |
|---|---|---|
Necesario. Marca específicamente el manifiesto como una solución de Office. |
Ninguno |
|
Necesario. Almacena los puntos de entrada en un espacio de nombres único. |
Ninguno |
|
Necesario. Agrupa todos los ensamblados que se van a ejecutar. |
Ninguno |
|
Necesario. Identifica el ensamblado que se va a ejecutar. |
class contract |
|
Necesario. Configura las actualizaciones para la solución. |
enabled expiration |
|
Necesario. Ajusta la información específica de la aplicación en un nodo único. |
Ninguno |
|
Necesario. Almacena la información específica de la aplicación host en un espacio de nombres independiente. |
xmlns |
|
Sólo es necesario para las soluciones de nivel de documento. Almacena la información específica de la personalización. |
solutionId |
|
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 |
|
Opcional. Almacena el nombre del complemento que aparece en la lista de complementos instalados. |
Ninguno |
|
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 |
|
Sólo se requiere para complementos de Outlook 2007 que incluyen áreas de formulario. |
Ninguno |
|
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)