Actualizar y migrar soluciones de Office

  • Artículo

Si tiene un proyecto de Microsoft Office que se creó en una versión anterior de Visual Studio, debe actualizar el proyecto para usarlo en Visual Studio 2010. Para actualizar un proyecto de Microsoft Office, ábralo en una versión de Visual Studio 2010 que incluya las herramientas para desarrolladores de Microsoft Office. Para obtener más información sobre el proceso de actualización, vea Cómo: Actualizar soluciones de Office. Para obtener más información sobre las versiones de Visual Studio 2010 que incluyen las herramientas para desarrolladores de Microsoft Office, vea Configurar un equipo para desarrollar soluciones de Office.

Al actualizar un proyecto de Microsoft Office, Visual Studio realiza varios cambios en el proyecto. Algunos de los cambios dependen de la versión de .NET Framework y Microsoft Office que esté instalada en el equipo de desarrollo y de si se trata de un proyecto de nivel de documento o de nivel de aplicación.

También puede cambiar en cualquier momento la versión de .NET Framework de destino de los proyectos de Office de .NET Framework 3.5 a .NET Framework 4, o viceversa. Para obtener más información, vea Cómo: Elegir perfil o versión de destino de .NET Framework. Si cambia la versión de .NET Framework de destino, podría ser necesario realizar algunos pasos adicionales para ejecutar la solución con destino nuevo en los equipos de desarrollo y de los usuarios finales, y su proyecto ya no se compilará si usa ciertas características. Para obtener más información, vea Migrar soluciones de Office a .NET Framework 4.

Nota

Visual Studio 2010 no pueden actualizar proyectos de plantilla de formulario de InfoPath que se crearon con versiones anteriores de Visual Studio. Estos tipos de proyectos ya no se admiten en Visual Studio 2010.

Versiones compatibles para la actualización de proyectos

Puede actualizar proyectos de Office creados en cualquiera de las siguientes versiones de Visual Studio Tools para Office:

  • Microsoft Visual Studio 2005 Tools para Microsoft Office System.

  • Microsoft Visual Studio 2005 Tools para Microsoft Office System 2007 (VSTO 2005 SE).

  • Microsoft Visual Studio Tools para Microsoft Office System (versión 3.0). Esta versión de Visual Studio Tools para Office se incluía con Visual Studio 2008.

Visual Studio 2010 no admite la actualización de proyectos de Microsoft Office creados mediante Visual Studio Tools para Office, versión 2003. Para continuar desarrollando uno de estos proyectos en Visual Studio 2010, cree un nuevo proyecto de Office y traslade manualmente el código al nuevo proyecto.

Nota

Visual Studio Tools para Office era el nombre de las herramientas para desarrolladores de Microsoft Office en versiones anteriores de Visual Studio.

Cambios en los proyectos actualizados

Al actualizar un proyecto de Microsoft Office, Visual Studio realiza los siguientes cambios en el proyecto:

  • Actualiza la versión del runtime de Visual Studio Tools para Office de destino del proyecto a Visual Studio 2010 Tools para Office Runtime.

    Para obtener más información acerca del motor en tiempo de ejecución de Visual Studio Tools para Office, vea Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

  • Actualiza la versión de .NET Framework de destino del proyecto, si es necesario.

  • Actualiza las referencias de ensamblado del proyecto.

  • Modifica el proyecto para que tenga como destino la versión de Microsoft Office que ha instalado en el equipo de desarrollo (Microsoft Office 2010 o 2007 Microsoft Office system) si el proyecto original estaba destinado a una versión anterior de Microsoft Office. Si no se ha instalado ninguna versión de Microsoft Office, el proyecto actualizado tiene como destino 2007 Microsoft Office system.

.NET Framework de destino

Al actualizar un proyecto de Visual Studio Tools para Office en Visual Studio 2010, Visual Studio modifica la versión de .NET Framework de destino en los siguientes casos:

  • El proyecto original está destinado a .NET Framework 2.0. En este caso, Visual Studio modifica el proyecto para que tenga como destino .NET Framework 3.5, si .NET Framework 3.5 y .NET Framework 4 están instalados en el equipo de desarrollo. Si solo se instala .NET Framework 4, Visual Studio modifica el proyecto para que tenga como destino .NET Framework 4.

  • El proyecto tiene como destino .NET Framework 3.5 pero únicamente .NET Framework 4 está instalado en el equipo de desarrollo. En este caso, Visual Studio modifica el proyecto para que tenga como destino .NET Framework 4.

Si el proyecto ya tiene como destino .NET Framework 3.5, Visual Studio no actualizará la versión de .NET Framework de destino en el proyecto actualizado si .NET Framework 3.5 también está instalado en el equipo de desarrollo.

Nota

Si Visual Studio cambia la versión de .NET Framework de destino a .NET Framework 4, podría ser necesario realizar algunos pasos adicionales para ejecutar la solución con destino nuevo en los equipos de desarrollo y de los usuarios finales, y su proyecto ya no se compilará si usa ciertas características. Para obtener más información, vea Migrar soluciones de Office a .NET Framework 4.

En la siguiente tabla se resumen los cambios de la versión de .NET Framework de destino para los proyectos actualizados.

Versión de .NET Framework de destino del proyecto original

Versiones de .NET Framework del equipo de desarrollo

Versión de .NET Framework de destino del proyecto actualizado

.NET Framework 2.0

.NET Framework 3.5

.NET Framework 3.5

y

.NET Framework 4

.NET Framework 3.5

NotaNota
Si el proyecto original está destinado a .NET Framework 3.5 Client Profile, el proyecto actualizado tiene como destino .NET Framework 3.5.

.NET Framework 2.0

.NET Framework 3.5

.NET Framework 4

.NET Framework 4

NotaNota
Si el proyecto original está destinado a .NET Framework 3.5 Client Profile, el proyecto actualizado tiene como destino .NET Framework 4 Client Profile.

Si se usa .NET Framework 4 como destino en un proyecto de Office, se pueden aprovechar ciertas características que no están disponibles cuando el destino es .NET Framework 3.5. Para obtener más información, vea Diseñar y crear soluciones de Office.

Referencias de ensamblado

Visual Studio actualiza las siguientes referencias de ensamblado en el proyecto:

Visual Studio no agrega referencias a las versiones nuevas o actualizadas de los ensamblados que se hayan agregado al proyecto original una vez creado. Por ejemplo, si actualiza un proyecto de complemento de Word 2003 que también hace referencia al ensamblado de interoperabilidad primario de PowerPoint 2003, Visual Studio modifica el proyecto actualizado para hacer referencia al ensamblado de interoperabilidad primario de Word 2007 o Word 2010. Sin embargo, debe actualizar manualmente la referencia al ensamblado de interoperabilidad primario de PowerPoint.

Actualizar proyectos de Microsoft Office 2003

De forma predeterminada, si Microsoft Office 2010 o 2007 Microsoft Office system está instalado en su equipo de desarrollo al actualizar un proyecto destinado a Microsoft Office 2003, Visual Studio modifica el proyecto para que use como destino la versión de Microsoft Office que ha instalado. La casilla Actualizar siempre a la versión de Office instalada en la página opciones de Actualización de proyecto controla este comportamiento. Si desactiva esta casilla, Visual Studio no modifica el proyecto para que esté destinado a Microsoft Office 2010 o 2007 Microsoft Office system, y es posible que no pueda abrir, depurar o ejecutar el proyecto. Para obtener más información sobre esta opción, vea Actualización de proyecto, cuadro de diálogo Opciones.

Hay algunas consideraciones adicionales para actualizar las personalizaciones en el nivel del documento y los complementos en el nivel de la aplicación para Microsoft Office 2003.

Proyectos de nivel de documento

Para actualizar un proyecto de nivel de documento para Microsoft Office 2003, debe tener la aplicación correspondiente de Microsoft Office 2010 o 2007 Microsoft Office system instalada en el equipo de desarrollo. Por ejemplo, debe instalar Word 2007 o Word 2010 en el equipo antes de poder actualizar un proyecto de Word 2003.

Al actualizar un proyecto de nivel de documento con un documento que está guardado en un formato binario, debe decidir si va a convertir el documento en un formato XML abierto o si va a mantener el documento en un formato binario. A menos que tenga una razón concreta para usar el formato anterior, debería seleccionar el formato XML abierto. Para obtener más información sobre XML abierto, vea Introduction to new file name extensions and Office XML Formats.

Si el documento del proyecto contiene controles Windows Forms, también debe tener instalado Visual Studio 2005 Tools para Office Second Edition Runtime antes de actualizar el proyecto. Si esta versión del runtime no está instalada en el equipo de desarrollo antes de actualizar el proyecto, podría haber errores de compilación o en tiempo de ejecución en el proyecto actualizado. Una vez actualizado el proyecto, puede desinstalar Visual Studio 2005 Tools para Office Second Edition Runtime del equipo de desarrollo si no lo va a utilizar ninguna otra solución de Office. Esta versión del runtime está disponible como un paquete redistribuible desde el Centro de descarga de Microsoft en Visual Studio 2005 Tools para Office Second Edition Runtime (VSTO 2005 SE) (x86).

Proyectos de nivel de aplicación

Si el archivo de solución del proyecto original incluye un proyecto de instalación configurado para instalar el complemento de nivel de aplicación, Visual Studio actualiza el proyecto de instalación a un proyecto de Visual Studio 2010, pero no realiza ningún cambio adicional en el proyecto. Si desea seguir usando un archivo de Windows Installer para implementar el complemento, debe modificar el proyecto de instalación para instalar nuevos requisitos previos, como .NET Framework 4 o .NET Framework 3.5, Visual Studio 2010 Tools para Office Runtime y, opcionalmente, los ensamblados de interoperabilidad primarios a los que se hace referencia en el complemento. Para obtener más información, vea Implementar una solución de Office mediante Windows Installer.

Si desea usar ClickOnce para implementar el complemento, puede eliminar el proyecto de instalación por completo. Para obtener más información sobre cómo implementar complementos mediante ClickOnce, vea Implementar soluciones de Office.

Vea también

Tareas

Cómo: Actualizar soluciones de Office

Referencia

Actualización de proyecto, cuadro de diálogo Opciones

Conceptos

Migrar soluciones de Office a .NET Framework 4