Información general sobre los ensamblados en las soluciones de Office

Actualización: noviembre 2007

El código que se escribe en los proyectos de Visual Studio Tools para Office se compila finalmente en un ensamblado. Los ensamblados en las soluciones de Visual Studio Tools para Office normalmente se implementan en un servidor compartido o en un directorio en el equipo cliente.

Para obtener más información sobre los ensamblados, vea Información general sobre ensamblados.

Ensamblados en las soluciones de Office

Los ensamblados en los proyectos de Visual Studio Tools para Office los carga una aplicación de Microsoft Office. Una vez cargado el ensamblado, el código del ensamblado puede responder a los eventos que se producen en la aplicación (por ejemplo, cuando el usuario hace clic en un elemento de menú). El código del ensamblado también puede llamar al modelo de objetos para automatizar y extender la aplicación y puede utilizar cualquiera de las clases de .NET Framework. Para obtener más información, consulte Arquitectura de las personalizaciones de nivel de documento y Arquitectura de los complementos de nivel de aplicación.

Las soluciones de Visual Studio Tools para Office utilizan manifiestos de implementación y manifiestos de aplicación para identificar el ensamblado. Los manifiestos contienen información sobre el nombre, la versión y la ubicación del ensamblado de modo que la aplicación pueda encontrar el ensamblado correcto, vincularse a él y ejecutarlo. Para obtener más información, consulte Manifiestos de implementación y aplicación en soluciones de Office.

Los proyectos de nivel de documento incluyen un documento además de un ensamblado. El documento actúa como la interfaz de usuario de la aplicación y es en él donde se produce toda la interacción del usuario. Cada documento sólo puede tener asociado un ensamblado de proyecto principal; sin embargo, varios documentos pueden hacer referencia al mismo ensamblado.

Los ensamblados en los proyectos de nivel de documento no están incrustados en el documento; están almacenados en otra parte y se identifican mediante el manifiesto de aplicación del documento.

Consideraciones de seguridad para los ensamblados

Para que una solución de Visual Studio Tools para Office se ejecute en un equipo, los ensamblados usados por la solución deben ser de confianza. Los ensamblados para las soluciones de Microsoft Office 2007 y Microsoft Office 2003 tienen diferentes requisitos de confianza. Para obtener más información sobre la seguridad, vea Seguridad en las soluciones de Office (2007 System) y Seguridad en las soluciones de Office (2003 System).

De manera predeterminada, el ensamblado de la solución y los ensamblados a los que se hace referencia que están ubicados en la carpeta de resultados del proyecto reciben confianza para ejecutarse en el equipo de desarrollo cuando se genera el proyecto. Para obtener más información, consulte Información general acerca del proceso de compilación de soluciones de Office.

Por razones de seguridad, es preferible crear proyectos en el equipo local, en lugar de desarrollarlos en una ubicación compartida. Para obtener más información, vea Desarrollo en colaboración de las soluciones de Office.

Referencias a ensamblados

El ensamblado puede hacer referencia a otros ensamblados, que se enumeran en las referencias del proyecto. Sin embargo, un ensamblado de proyecto de nivel de documento no puede hacer referencia a otro ensamblado de proyecto de nivel de documento.

Compatibilidad con el modo sin conexión para los ensamblados a los que se hace referencia en las soluciones de Microsoft Office 2003

Si la solución de Microsoft Office 2003 depende de la memoria caché de Internet Explorer en lo que se refiere a proporcionar funcionalidad sin conexión, debe cargar explícitamente todos los ensamblados a los que se hace referencia; de lo contrario, podrían no estar disponibles para la aplicación cuando no haya conexión. Los ensamblados no se cargan en la caché de Internet Explorer hasta que se utilizan. Si la solución no llamó a un ensamblado al que se hace referencia mientras estaba establecida la conexión, dicho ensamblado no estará disponible sin conexión. Para asegurarse de que todos los ensamblados están cargados en la caché al abrir la solución durante la conexión, llame a Load en cada ensamblado al que se hace referencia en la solución del controlador de eventos Startup.

Para obtener más información sobre la compatibilidad con el modo sin conexión para las soluciones de Microsoft Office 2003, vea Modelo sin conexión para soluciones de Office (2003 System).

Vea también

Tareas

Cómo: Abrir soluciones de Office sin ejecutar código

Cómo: Apuntar a las aplicaciones de Office mediante los ensamblados de interoperabilidad primarios

Conceptos

Crear soluciones de Office en Visual Studio

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

Otros recursos

Arquitectura de las soluciones de Visual Studio Tools para Office