Diseño y creación de soluciones de Office

  • Artículo

Visual Studio proporciona plantillas de proyecto que puede usar para crear varios tipos distintos de soluciones de Office. En esta sección de la documentación se describen las plantillas de proyecto y se ofrecen instrucciones sobre cómo crear proyectos de Office. Para obtener información sobre cómo implementar personalizaciones de código e interfaz de usuario después de crear el proyecto, consulte Desarrollo de soluciones de Office.

Se aplica a: la información de este tema se aplica a proyectos de nivel de documento y proyectos de complementos de VSTO. Consulte Características disponibles por aplicación de Office lication y tipo de proyecto.

Nota:

¿Le interesa desarrollar soluciones que amplíen la experiencia de Office en varias plataformas? Consulte el nuevo modelo de complementos de Office. Los complementos de Office tienen una superficie pequeña en comparación con los complementos y soluciones de VSTO, y puede compilarlos mediante casi cualquier tecnología de programación web, como HTML5, JavaScript, CSS3 y XML.

Crear proyectos de Office

Antes de empezar, debe determinar los requisitos y el tipo de solución que mejor se adapta a sus necesidades. Por ejemplo, si su solución de Office debe ejecutarse cada vez que se utiliza la aplicación, un complemento de VSTO será lo que mejor se adapte a sus requisitos. Si el código está estrechamente integrado con un único documento, cree una personalización de nivel de documento. Estos tipos de proyecto están disponibles como plantillas de proyecto de Visual Studio. Para obtener más información sobre las plantillas de proyecto de Office que se incluyen con Visual Studio, consulte Introducción a las plantillas de proyecto de Office. Para obtener más información sobre cómo crear proyectos de Office, vea Cómo: Crear proyectos de Office en Visual Studio.

Los proyectos de Office tienen características y elementos de proyecto que difieren de otros tipos de proyectos de Visual Studio. Por ejemplo, cuando se crea un proyecto de nivel de documento, el documento o el libro del proyecto se puede abrir y editar en Visual Studio. Para obtener más información, vea Proyectos de Office en el entorno de Visual Studio.

Elección de una versión de .NET Framework

Después de seleccionar el tipo de proyecto que mejor se adapte a sus requisitos, puede elegir qué versión de .NET Framework se utilizará en el proceso de desarrollo. Puede elegir como destino las siguientes versiones de .NET Framework en los proyectos de Office:

  • .NET Framework 4

  • .NET Framework 4 Client Profile

  • .NET Framework 4.5

    La versión de .NET Framework que elija para el proyecto es necesaria en los equipos de usuario final para que se ejecute la solución. Por ejemplo, si el proyecto tiene como destino .NET Framework 4, se requiere .NET Framework 4 en equipos de usuario final. En este ejemplo, la solución no se ejecutará si solo .NET Framework 3.5 está instalado en equipos de usuario final.

    Si migra un proyecto de complemento de VSTO destinado a .NET Framework 3.5, Visual Studio cambia la plataforma de destino del proyecto a .NET Framework 4 o posterior, en función de la versión de Office que haya instalado.

    Sin embargo, una vez que Visual Studio cambie el marco de trabajo de destino, deberá modificar parte del código del proyecto si utiliza determinadas características. Para obtener más información sobre cómo cambiar la plataforma de destino, vea Cómo: Establecer como destino una versión de .NET Framework. Para obtener más información sobre los cambios que puede que necesite realizar en el proyecto, consulte Migración de soluciones de Office a .NET Framework 4 o posterior.

    Si Visual Studio cambia el .NET Framework de destino para el proyecto y usa ClickOnce para implementar la solución, asegúrese de seleccionar también la versión correspondiente de .NET Framework en el cuadro de diálogo Requisitos previos . Esta selección no cambia automáticamente al cambiar la plataforma de destino del proyecto. Para obtener más información, vea How to: Install prerequisites on end-user computers to run Office solutions.

Nota:

No puede tener como destino .NET Framework 3.5 ni versiones anteriores en proyectos de Office que cree mediante Visual Studio 2013. Los proyectos de Office que cree con Visual Studio 2013 requieren características que se introdujeron por primera vez en el perfil de cliente de .NET Framework 4

Comprender cuándo se requieren los PIA de Office en equipos de usuario final

De forma predeterminada, los ensamblados de interoperabilidad primarios (PIA) de Office no necesitan instalarse en equipos de usuario final si la propiedad Insertar tipos de interoperabilidad de cada referencia de PIA de Office en el proyecto se establece en True, que es el valor predeterminado. En este escenario, la información de tipo de los tipos de PIA que utiliza la solución se incrusta en el ensamblado de la solución al compilar el proyecto. En tiempo de ejecución, se usa la información de tipo incrustado en lugar de los PIA para llamar al modelo de objetos basado en COM de la aplicación de Office lication. Para obtener más información sobre cómo se insertan los tipos de PIA en la solución, consulte Tipos de equivalencia de tipos y tipos de interoperabilidad insertados.

Si la propiedad Insertar tipos de interoperabilidad de cada referencia de PIA de Office en el proyecto está establecida en False, los PIA de Office deben instalarse y registrarse en la caché global de ensamblados en cada equipo de usuario final que ejecute la solución. En la mayoría de los casos, los PIA se instalan de forma predeterminada con Office, pero también puede incluir el redistribuible de PIA como un requisito previo para una solución. Para obtener más información, consulte Requisitos previos de la solución de Office para la implementación.

Descripción del perfil de cliente

.NET Framework Client Profile constituye un subconjunto de funcionalidades de la versión completa de .NET Framework. Puede elegir como destino .NET Framework Client Profile si solo necesita utilizar las características de cliente de .NET Framework y desea proporcionar la experiencia de implementación más rápida posible para una solución de Office. Para más información, consulte Perfil de cliente de .NET Framework.

Al crear un proyecto de Office destinado a .NET Framework 4, el perfil de cliente de .NET Framework 4 está dirigido de forma predeterminada. Si desea desarrollar para .NET Framework 4 completo, debe establecer esta opción después de crear el proyecto. Para obtener más información, vea Cómo: Usar una versión de .NET Framework como destino.

Crear soluciones para la edición de 64 bits de Microsoft Office

Microsoft Office está disponible en ediciones de 64 bits y 32 bits. Para crear soluciones de Office que se puedan ejecutar en cualquiera de las ediciones, la configuración de destino de la plataforma para el proyecto debe establecerse en Cualquier CPU. Este es el valor predeterminado para los proyectos de Office. Para obtener más información, vea Compilar soluciones de Office.

Hay versiones independientes de 64 y 32 bits del entorno de ejecución de Visual Studio Tools para Office que usan las ediciones de 64 y 32 bits de Microsoft Office. Para obtener más información, consulte Visual Studio Tools para Office información general del entorno de ejecución.

Ensamblados en soluciones de Office

Al crear un proyecto de Office mediante las herramientas de desarrollo de Office en Visual Studio, el código que se escribe se compila finalmente en un ensamblado. El ensamblado se implementa en un servidor compartido o en un directorio del equipo cliente.

Los ensamblados de las soluciones de Office se cargan a través de una aplicación de Office. Una vez cargado el ensamblado, el código del ensamblado puede responder a eventos que se produzcan en la aplicación, como, por ejemplo, cuando un usuario hace clic en un elemento de menú. El código del ensamblado también puede llamar al modelo de objetos para automatizar y ampliar la aplicación, y puede usar cualquiera de las clases de .NET Framework. Para obtener más información, consulte Arquitectura de personalizaciones de nivel de documento y Arquitectura de complementos de VSTO.

Las soluciones de Office usan manifiestos de implementación y de aplicación para identificar el ensamblado. Los manifiestos contienen información sobre el nombre, la versión y la ubicación del ensamblado, para que la aplicación pueda buscar y ejecutar el ensamblado adecuado, y establecer vínculos con este. Para obtener más información, vea Manifiestos de aplicación e implementación en soluciones de Office.

Los proyectos de nivel de documento incluyen un documento además de un ensamblado. El documento actúa como el front-end de la aplicación y es donde se realiza toda la interacción del usuario. Cada documento solo puede tener un ensamblado de proyecto principal asociado a él. Sin embargo, varios documentos pueden apuntar al mismo ensamblado.

Los ensamblados en los proyectos de nivel de documento no se incrustan en el documento, sino que se almacenan en otra ubicación y se identifican mediante el manifiesto de aplicación del documento.

Consideraciones de seguridad para ensamblados

Para que una solución de Office se ejecute en un equipo y lo hagan también los ensamblados que esta usa, estos ensamblados deben ser de confianza. Para obtener más información sobre la seguridad, consulte Soluciones seguras de Office.

De forma predeterminada, el ensamblado de la solución y los ensamblados a los que se hace referencia y que se encuentran en la carpeta de salida del proyecto son de confianza para ejecutarse en el equipo de desarrollo al compilar el proyecto. Para obtener más información, vea Compilar soluciones de Office.

Por motivos de seguridad, es mejor crear proyectos en el equipo local, en lugar de desarrollarlos en una ubicación compartida. Para obtener más información, consulte Desarrollo colaborativo de soluciones de Office.

Ensamblados a los que se hace referencia

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.

Contenido relacionado