Atualizando e Migrando soluções do Office

Artigo
08/25/2010

Use o Assistente para conversão do Visual Studio para atualizar projetos de O Visual Studio Tools for Office, versão 2003 e Microsoft Visual Studio 2005 Tools para o Microsoft Office Sistema a O Visual Studio Tools for o sistema Office 3.0.Para atualizar uma solução do Microsoft Office, Abrir a solução no Visual Studio com O Visual Studio Tools for o sistema Office 3.0 instalado.O Assistente para conversão do Visual Studio aparece e o conduzirá pelas etapas necessárias para concluir a Atualizar.For more information, see Como: Atualizar soluções de Visual Studio Tools para Office.

O Assistente não modifica seu código.Se você atualizar um Outlook 2003 Adicionar-em um projeto, talvez seja necessário atualizar manualmente seu código.Para obter mais informações, consulte Outlook projetos.

Referências de Assembly

O Assistente para conversão do Visual Studio atualiza o arquivo de projeto e a referência assembly de interoperabilidade primária do aplicativo Microsoft Office principal para a solução.Além disso, ele adiciona as referências a versões Novo ou atualizadas de assemblies dependentes.No entanto, o assistente não Adicionar referências a versões Novos ou atualizadas de módulos (assemblies) que você manualmente Adicionar para o projeto depois que o projeto original foi criado.

Por exemplo, se você atualizar o Word 2003 Adicionar - no projeto que possui referências a um assembly de método auxiliar e o PowerPoint assembly de interoperabilidade primária, o Assistente para conversão do Visual Studio garante que referências para o assembly de interoperabilidade primário do Word e o assembly auxiliar estejam corretas.No entanto, você deve atualizar a referência o assembly de interoperabilidade primária do PowerPoint manualmente.

Atualizações de versão

Por padrão, se você tiver o 2007 Microsoft Office Sistema instalado, o assistente atualiza projetos do Microsoft Office 2003 para que eles se tornam projetos para o 2007 Microsoft Office Sistema.No entanto, o processo é diferente para personalizações em nível de documento e o nível de aplicativo Adicionar-ins.

Projetos de personalização de nível de documento

Se você estiver atualizando uma personalização de nível de documento, não é possível para impedir que o Assistente de atualização a versão do projeto.Isso ocorre porque o designer que aparece quando você Abrir uma personalização de nível de documento usa a versão atualmente instalada do Office.O projeto pode abrir no designer somente se ele corresponder a versão do Office que está instalado.

Para atualizar um projeto de personalização de nível de documento, você deve ter o aplicativo apropriado do Office instalado.Por exemplo, você deve ter o Word 2003 ou no Word 2007 instalado no computador antes de poder atualizar um projeto de personalização de nível de documento do Word 2003.

Se você tiver o 2007 Microsoft Office Sistema instalado, o Assistente para conversão do Visual Studio Requer que você escolha se deseja converter o documento em um do XML de Abrir formatos.Você deve converter o Formatarar do documento, a menos que você tenha um motivo específico para usar o Formatarar mais antigo.Para obter mais informações sobre esses formatos, consulte Introdução aNovo Nome do Arquivo extensões e os formatos XML abertos.

Se você tiver o Microsoft Office 2003 instalado quando você atualizar o projeto, o projeto continuará a usar o Microsoft Office 2003 como a versão de destino e o Formatarar do documento permanecerá a mesma.

Se você atualizar um projeto de nível de documento que você criou usando O Visual Studio Tools for Office, versão 2003, você deve executar algumas etapas da atualização manualmente.For more information, see Atualizando de Visual Studio Tools for Office, versão 2003.

Nível de aplicativo Adicionar - in de projetos

Se você tiver o 2007 Microsoft Office Sistema instalado, e você não deseja Assistente para conversão do Visual Studio atualizar versão 2003 suplemento projetos para projetos de Adicionar-in de versão 2007, você pode alterar o padrão para que permaneçam projetos do Office 2003.Desde que a versão 2007 do Office pode Host Office Adicionar-ins, você pode desenvolver, compilar e testar o projeto, mesmo que você não tenha o Microsoft Office 2003 instalado.Limpar a Atualizar de sempre Para versão instalada do Office opção a página de opções de Atualizar do projeto.For more information, see Projeto de Atualizar, caixa de diálogo Opções.

O Assistente para conversão do Visual Studio não é possível tornar Adicionar - em projetos compatíveis com uma versão anterior do Office.Portanto, se você tiver Office 2003 instalado e atualizar um projeto de Adicionar-in da versão 2007, o projeto permanece um projeto de suplemento da versão 2007 após a atualização for Concluir.Você pode abrir o projeto, desenvolver o Adicionar-in e Compilar código com êxito.No entanto, você não pode testar o suplemento porque o Office 2003 não Host versão 2007 Adicionar-ins.

Você não precisa ter o Microsoft Office instaladas para atualizar um nível de aplicativo Adicionar no projeto.

Projetos do Outlook

Se você atualizar um Outlook 2003 Adicionar - em um projeto, você deve atualizar o nome da sua classe de item de host e você deve atualizar referências ao objeto Microsoft.Office.Interop.Outlook.Application.

Observação:
Y ou não é necessário t o projeto de Atualizar s que você criou usando Microsoft Visual Studio 2005 Tools para o 2007 Microsoft Office Sistema Modelos de projeto (O VSTO 2005 SE).

Nome de classe item de host

O Assistente para conversão do Visual Studio não Atualizar o nome da sua classe de item de host.O nome da classe continua a ser ThisApplication.Você não precisará alterar esse nome.No entanto, exemplos de código em O Visual Studio Tools for o sistema Office 3.0 documentação de ajuda usam item de host Nome de Classe ThisAddIn.Se você deseja que tornar mais fácil testar código copiá-lo e colando-o em seu próprio projeto, você pode alterar o nome da classe para ThisAddIn e, em seguida, refatorar essa alteração de nome ao longo do projeto.Para obter informações sobre como Refatorar código um projeto C#, consulte Como: Renomear identificadores.Para obter informações sobre como Refatorar código em um projeto de Visual Basic , consulte Como: Renomear um identificador.

Referências para o objeto Aplicativo

O Assistente para conversão do Visual Studio não modifica seu código.Portanto, você deve alterar manualmente Todo o Código que usa uma das seguintes técnicas para acessar o objeto Microsoft.Office.Interop.Outlook.Application:

O this (em C#) ou a palavra-chave Me (em Visual Basic) dentro da classe ThisApplication.
O objeto Globals.ThisApplication no código fora a classe ThisApplication.

Por exemplo, se sua classe ThisApplication contiver o código a seguir, você deve Atualizar-lo.

Me.ActiveExplorer()

this.ActiveExplorer();

O código a seguir funciona como a substituição de projetos atualizados.

Me.Application.ActiveExplorer()

This.Application.ActiveExplorer();

A classe de item de host ThisApplication no projetos de Microsoft Visual Studio 2005 Tools para o Microsoft Office Sistema herda diretamente da classe Microsoft.Office.Tools.Outlook.Application.No entanto, a classe de item de host ThisAddIn no O Visual Studio Tools for o sistema Office 3.0 projetos não não herda Microsoft.Office.Tools.Outlook.Application.Em vez disso, você Referência objeto do aplicativo ativo usando a propriedade Application da classe de item de host.

Atualizando para a versão 2007 do Microsoft Office

Se você atualizar para a versão 2007 do Microsoft Office após atualizar um projeto Ferramentas do Visual Studio para o Office , do Assistente para conversão do Visual Studio aparecerão na Avançar vez que você Abrir o projeto.

Adicionar-em projetos para o 2007 a versão do Office que você optou por não atualizar quando você tinha o Office 2003 instalado agora será executado e você pode testá-las pressionando F5 ou CTRL + F5 no Visual Studio.

Consulte também