Actualizar y migrar soluciones de Office
Actualización: noviembre 2007
Utilice el Asistente para conversión de Visual Studio para actualizar proyectos de Visual Studio Tools para Office, versión 2003y Microsoft Visual Studio 2005 Tools para Microsoft Office System a Visual Studio Tools para Microsoft Office System 3.0. Para actualizar una solución de Microsoft Office, abra la solución en Visual Studio con Visual Studio Tools para Microsoft Office System 3.0 instalado. Aparece el Asistente para conversión de Visual Studio, que le guía a través de los pasos necesarios para completar la actualización. Para obtener más información, vea Cómo: Actualizar soluciones de Visual Studio Tools para Office.
El asistente no modifica su código. Si actualiza un proyecto de complemento de Outlook 2003, puede que sea necesario actualizar el código manualmente. Para obtener más información, vea Proyectos de Outlook.
Referencias de ensamblado
El Asistente para conversión de Visual Studio actualiza el archivo de proyecto y la referencia al ensamblado de interoperabilidad primario de la aplicación principal de Microsoft Office para la solución. Además, agrega referencias a las versiones nuevas o actualizadas de los ensamblados dependientes. Sin embargo, el asistente no agrega referencias a las versiones nuevas o actualizadas de ensamblados que se hayan agregado manualmente al proyecto una vez creado el proyecto original.
Por ejemplo, si actualiza un proyecto de complemento de Word 2003 que incluye referencias a un ensamblado de método auxiliar y al ensamblado de interoperabilidad primario de PowerPoint, el Asistente para conversión de Visual Studio asegura que las referencias al ensamblado de interoperabilidad primario de Word y al ensamblado de aplicación auxiliar sean correctas. Sin embargo, debe actualizar manualmente la referencia al ensamblado de interoperabilidad primario de PowerPoint.
Actualizaciones de versiones
De forma predeterminada, si tiene instalado 2007 Microsoft Office system, el asistente actualiza los proyectos de Microsoft Office 2003 a proyectos de 2007 Microsoft Office system. Sin embargo, el proceso es distinto para las personalizaciones de nivel de documento y los complementos de nivel de aplicación.
Proyectos de personalización de nivel de documento
Si va a actualizar una personalización de nivel de documento, no existe ninguna forma de evitar que el asistente actualice la versión del proyecto. Esto se debe a que el diseñador que aparece al abrir una personalización de nivel de documento utiliza la versión de Office instalada actualmente. El proyecto sólo se puede abrir en el diseñador si coincide con la versión instalada de Office.
Para actualizar un proyecto de personalización de nivel de documento, debe tener instalada la aplicación de Office adecuada. Por ejemplo, debe tener Word 2003 o Word 2007 instalado en el equipo para poder actualizar un proyecto de personalización de nivel de documento de Word 2003.
Si tiene instalado Microsoft Office system 2007, el Asistente para conversión de Visual Studio requiere que decida si desea convertir el documento a uno de los formatos XML abiertos de Office. A menos que tenga una razón concreta para utilizar el formato anterior, debería convertir el formato del documento. Para obtener más información sobre estos formatos, vea Introduction to new file name extensions and Office XML Formats.
Si tiene instalado Microsoft Office 2003 al actualizar el proyecto, éste seguirá utilizando Microsoft Office 2003 como versión de destino y el formato del documento no se modificará.
Si actualiza un proyecto de nivel de documento creado mediante Visual Studio Tools para Office, versión 2003, debe realizar algunos pasos de la actualización manualmente. Para obtener más información, vea Actualizar Visual Studio Tools para Office, versión 2003.
Proyectos de complemento de nivel de aplicación
Si tiene instalado 2007 Microsoft Office system y no desea que el Asistente para conversión de Visual Studio actualice los proyectos de complemento de la versión 2003 a la versión 2007, puede cambiar el valor predeterminado para que sigan siendo proyectos de Office 2003. Dado que la versión 2007 de Office puede hospedar complementos de Office 2003, podrá desarrollar, compilar y probar el proyecto aunque no tenga instalado Microsoft Office 2003. Desactive la opción Actualizar siempre a la versión de Office instalada de la página de opciones Actualización de proyecto. Para obtener más información, vea Actualización de proyecto, cuadro de diálogo Opciones.
El Asistente para conversión de Visual Studio no puede hacer que los proyectos de complemento sean compatibles con una versión anterior de Office. Por consiguiente, si tiene instalado Office 2003 y actualiza un proyecto de complemento de la versión 2007, éste seguirá siendo un proyecto de complemento de la versión 2007 una vez completada la actualización. Puede abrir el proyecto, desarrollar el complemento y compilar el código correctamente. Sin embargo, no puede probar el complemento porque Office 2003 no hospeda complementos de la versión 2007.
No es necesario tener instalado Microsoft Office para actualizar un proyecto de complemento de nivel de aplicación.
Proyectos de Outlook
Si actualiza un proyecto de complemento de Outlook 2003, debería actualizar el nombre de la clase de elemento host y las referencias al objeto Microsoft.Office.Interop.Outlook.Application.
.gif "Nota") Nota: |
|---|
No es necesario actualizar los proyectos creados con plantillas de proyecto de Microsoft Visual Studio 2005 Tools para Microsoft Office System 2007 (VSTO 2005 SE). |
Nombre de la clase de elemento host
El Asistente para conversión de Visual Studio no actualiza el nombre de la clase de elemento host. El nombre de la clase sigue siendo ThisApplication. No es necesario cambiar este nombre. Sin embargo, los ejemplos de código de la documentación de Ayuda de Visual Studio Tools para Microsoft Office System 3.0 utilizan el nombre de clase de elemento host ThisAddIn. Si desea poder probar el código de forma más sencilla copiándolo y pegándolo en su propio proyecto, puede cambiar el nombre de la clase a ThisAddIn y, a continuación, refactorizar este cambio de nombre en todo el proyecto. Para obtener información sobre cómo refactorizar el código en un proyecto de C#, vea Cómo: Cambiar el nombre de los identificadores. Para obtener información sobre cómo refactorizar el código en un proyecto de Visual Basic, vea Cómo: Cambiar el nombre de un identificador.
Referencias al objeto Application
El Asistente para conversión de Visual Studio no modifica el código. Por consiguiente, debe cambiar manualmente todo el código que utiliza cualquiera de las técnicas siguientes para tener acceso al objeto Microsoft.Office.Interop.Outlook.Application:
La palabra clave this (en C#) o Me (en Visual Basic) dentro de la clase ThisApplication.
El objeto Globals.ThisApplication en el código fuera de la clase ThisApplication.
Por ejemplo, si su clase ThisApplication contiene el código siguiente, debe actualizarlo.
Me.ActiveExplorer()
this.ActiveExplorer();
El código siguiente funciona como reemplazo en los proyectos actualizados.
Me.Application.ActiveExplorer()
This.Application.ActiveExplorer();
La clase de elemento host ThisApplication en proyectos de Microsoft Visual Studio 2005 Tools para Microsoft Office System hereda directamente de la clase Microsoft.Office.Tools.Outlook.Application. Sin embargo, la clase de elemento host ThisAddIn en proyectos de Visual Studio Tools para Microsoft Office System 3.0 no hereda de Microsoft.Office.Tools.Outlook.Application. En su lugar, se hace referencia al objeto de aplicación activo mediante la propiedad Application de la clase del elemento host.
Actualizar a la versión 2007 de Microsoft Office
Si actualiza a la versión 2007 de Microsoft Office después de actualizar un proyecto de Visual Studio Tools para Office, el Asistente para conversión de Visual Studio aparecerá la próxima vez que se abra el proyecto.
Los proyectos de complemento de la versión 2007 de Office que decidió no actualizar cuando tenía instalado Office 2003 se podrán ejecutar ahora; podrá probarlos presionando F5 o CTRL+F5 en Visual Studio.
Vea también
Tareas
Cómo: Actualizar soluciones de Visual Studio Tools para Office
Conceptos
Actualizar Visual Studio Tools para Office, versión 2003