Actualizar y migrar soluciones de Office

Artículo
02/19/2013

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 2012.Para actualizar un proyecto de Microsoft Office, ábralo en una versión de Visual Studio 2012 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 2012 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 ha instalado en el equipo de desarrollo, y si el proyecto es un proyecto de nivel de documento o de nivel de aplicación.

[!NOTA]

Visual Studio 2012 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 2012.

Versiones compatibles para la actualización de proyectos

Puede actualizar los proyectos de Office creados con cualquiera de las versiones de herramientas de Office en Visual Studio.

Microsoft Visual Studio 2005 Tools for the Microsoft Office System.
Herramientas de Microsoft Visual Studio 2005 para 2007 Microsoft Office system (VSTO 2005 SE).
Herramientas de Microsoft Visual Studio tools para Microsoft Office system (versión 3,0).Esta versión de Visual Studio Tools para Office incluida con Visual Studio 2008.
Herramientas de desarrollo de Microsoft Office en Visual Studio 2010.

Visual Studio 2012 no permite actualizar los proyectos de Microsoft Office creados utilizando Visual Studio Tools para Office, versión 2003.Para continuar desarrollando uno de estos proyectos en Visual Studio 2012, 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 modifica el proyecto al destino los elementos siguientes:

Visual Studio 2010 Tools para Office Runtime.Para obtener más información, vea Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.
Una versión de .NET Framework compatible con el tipo de proyecto.
Una versión de Microsoft Office admitida por el tipo de proyecto.
Las referencias actuales del ensamblado.

.NET Framework de destino

Al actualizar un proyecto en Visual Studio 2012, Visual Studio modifica el proyecto al destino .NET Framework 4..NET Framework 4 se instala automáticamente cuando se instala Visual Studio 2012.

Si instala las herramientas de Microsoft Office Developer para Visual Studio 2012 y después actualizar un proyecto en Visual Studio 2012, Visual Studio modifica el proyecto al destino .NET Framework 4.5.Las soluciones de Office pueden destino .NET Framework 4.5 sólo si instala las herramientas de Microsoft Office Developer para Visual Studio 2012.Para obtener más información, vea “herramientas” en Página de descarga.

[!NOTA]

Puede ser necesario realizar algunos pasos adicionales para ejecutar una solución con destino nuevo en los equipos de desarrollo y del usuario final, y el 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 o .NET Framework 4.5.

Si el destino .NET Framework 4 o .NET Framework 4.5 en un proyecto de Office, puede utilizar algunas 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.

Aplicación de Office de destino

Al actualizar un proyecto de Office, Visual Studio modifica el proyecto destinado a una versión de Microsoft Office admitida por el tipo de proyecto, como un proyecto de personalización de nivel de documento o proyecto de complemento de nivel de aplicación.

Proyectos de Office en el destino sólo Office 2013 de la capacidad de Visual Studio 2012 y aplicaciones de Office 2010.Si Office 2013 está instalado, Visual Studio modifica el proyecto al destino Office 2013.Si Office 2010 está instalado, Visual Studio modifica el proyecto al destino Office 2010.Si ninguna de las dos versiones de Office se instala, Visual Studio 2012 no actualiza el proyecto.

[!NOTA]

Si actualiza un proyecto de complemento al destino Office 2013, asegúrese de que el controlador de eventos ThisAddIn_Startup del complemento no contiene el código que tiene acceso a un documento en la aplicación.Para obtener más información, vea Accessing a Document when the Office Application Starts.

Para las personalizaciones de nivel de documento, Visual Studio convierte los documentos en un proyecto con un formato binario, como documentos que tienen una extensión .xls o .doc, al formato XML abierto de Office.Para obtener más información sobre Office Open XML abierto, vea Introducción a las nuevas extensiones de nombres de archivo y a formatos XML de Office.

[!NOTA]

Las etiquetas inteligentes están desusadas en Excel 2010 y en Word 2010Por consiguiente, si la solución utiliza etiquetas inteligentes, debe quitarlos antes de poder probarlo y depurar en Visual Studio 2012.

Referencias de ensamblado

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

Ensamblados de interoperabilidad primarios (PIAs) de Microsoft Office.
Ensamblados de Runtime de Microsoft Visual Studio Tools para Office.Para obtener más información sobre estos ensamblados, vea Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.
Versiones nuevas o actualizadas de ensamblados dependientes.

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 2010.Sin embargo, debe actualizar manualmente la referencia al ensamblado de interoperabilidad primario de PowerPoint.

Actualizar proyectos de Microsoft Office 2003

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

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, el proyecto actualizado podría contener errores de compilación o en tiempo de ejecución.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 para el proyecto original incluye una configuración o un proyecto de InstallShield Limited edition configurados para instalar el complemento de nivel de aplicación, Visual Studio actualiza el proyecto a un proyecto de Visual Studio 2012, pero no realiza ningún al proyecto.Si desea seguir usando un archivo de Windows Installer para implementar el complemento, debe modificar la configuración o el proyecto de InstallShield Limited edition para instalar nuevos requisitos previos como .NET Framework 4, Visual Studio 2010 Tools para Office Runtime, y opcionalmente los ensamblados de interoperabilidad primarios a los que hace referencia 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 la configuración o el proyecto de InstallShield Limited edition completamente.Para obtener más información sobre cómo implementar complementos mediante ClickOnce, vea Implementar una solución de Office.

Vea también

Compartir a través de