Compartilhar via

Atualizando e migrando soluções do Office

  • Artigo

Se você tiver um projeto de Microsoft Office foi criado em uma versão anterior do Visual Studio, você deve atualizar o projeto para usá-lo em Visual Studio 2010. Para atualizar um projeto de Microsoft Office, abra-o em uma versão do Visual Studio 2010 que inclui ferramentas de desenvolvedor de Microsoft Office. Para obter mais informações sobre o processo de atualização, consulte Como: Atualizar soluções do Office. Para obter mais informações sobre as versões do Visual Studio 2010 que inclui ferramentas de desenvolvedor de Microsoft Office, consulte Configurando um computador para desenvolver soluções do Office.

Quando você atualiza um projeto de Microsoft Office, Visual Studio faz várias alterações ao projeto. Algumas das alterações dependem da versão do.NET Framework e Microsoft Office que você instalou no computador de desenvolvimento, e se o projeto é um projeto de nível de documento ou um projeto de nível de aplicativo.

Você também pode alterar a estrutura de destino de projetos do Office a qualquer momento o.NET Framework 3.5 para o .NET Framework 4, ou vice versa. For more information, see Como: Destino de um específico.NET Framework versão ou perfil. Se você alterar a estrutura de destino, algumas etapas adicionais podem ser necessário para executar a solução redirecionada em computadores de usuário final e o desenvolvimento e seu projeto não será mais compilado se ele usar determinados recursos. For more information, see Migrando soluções do Office para o.NET Framework 4.

ObservaçãoObservação

Visual Studio 2010não é possível atualizar projetos de modelo de formulário do InfoPath que foram criados usando versões anteriores do Visual Studio. Não há suporte para esses tipos de projetos em Visual Studio 2010.

Versões de atualização com suporte do projeto

Você pode atualizar projetos do Office criados usando qualquer uma das seguintes versões do Visual Studio Tools for Office:

  • Microsoft Visual Studio 2005 Tools for the Microsoft Office System.

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

  • Microsoft Visual Studio Tools for the Microsoft Office system (versão 3.0). Esta versão do Visual Studio Tools for Office foi incluído com o 2008 de Visual Studio.

Visual Studio 2010não oferece suporte à atualização criados por meio de projetos de Microsoft Office Visual Studio Tools for Office, Versão 2003. Para continuar a desenvolver um desses projetos em Visual Studio 2010, crie um novo projeto do Office e a porta manualmente o seu código para o novo projeto.

ObservaçãoObservação

Visual Studio Tools for Office era o nome das ferramentas de desenvolvedor de Microsoft Office em versões anteriores do Visual Studio.

Alterações para projetos atualizados

Quando você atualiza um projeto de Microsoft Office, Visual Studio faz as seguintes alterações ao projeto:

  • Atualiza a versão do Visual Studio Tools for Office em tempo de execução destinos do projeto para o Visual Studio 2010 Tools for Office Runtime.

    Para obter mais informações sobre o Visual Studio Tools for Office tempo de execução, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.

  • Atualiza a versão do.NET Framework que se destina o projeto, se necessário.

  • Atualiza as referências de assembly no projeto.

  • Modifica o projeto para a versão do Microsoft Office que você instalou no computador de desenvolvimento de destino (Microsoft Office 2010 ou o sistema de Microsoft Office de 2007) se o projeto original direcionado a uma versão anterior do Microsoft Office. Se nenhuma versão do Microsoft Office estiver instalado, o projeto atualizado destina-se o sistema de Microsoft Office de 2007.

Alvo.NET Framework

Quando você atualiza um Visual Studio Tools for Office o projeto em Visual Studio 2010, Visual Studio modifica o destino.NET Framework nos seguintes casos:

  • Os destinos do projeto original do.NET Framework 2.0. Nesse caso, o Visual Studio modifica o projeto de destino do.NET Framework 3.5 se tanto o.NET Framework 3.5 e o .NET Framework 4 estão instalados no computador de desenvolvimento. Se apenas o .NET Framework 4 é instalado, o Visual Studio modifica o projeto de destino a .NET Framework 4.

  • Os destinos do projeto a.NET Framework 3.5, mas somente o .NET Framework 4 está instalado no computador de desenvolvimento. Nesse caso, o Visual Studio modifica o projeto de destino a .NET Framework 4.

Se o projeto já destina-se a.NET Framework 3.5, o Visual Studio não irá atualizar a estrutura de destino no projeto atualizado se a.NET Framework 3.5 também é instalado no computador de desenvolvimento.

ObservaçãoObservação

Se Visual Studio altera a estrutura de destino para o .NET Framework 4, algumas etapas adicionais podem ser necessário executar a solução redirecionada em computadores de usuário final e o desenvolvimento e o seu projeto não será mais compilado se ele usar determinados recursos. For more information, see Migrando soluções do Office para o.NET Framework 4.

A tabela a seguir resume as alterações de estrutura de destino para projetos atualizados.

Estrutura de destino do projeto original

Versões de Framework no computador de desenvolvimento

Estrutura de destino do projeto atualizado

.NET Framework 2.0

.NET Framework 3.5

.NET Framework 3.5

and

.NET Framework 4

.NET Framework 3.5

ObservaçãoObservação
Se os destinos do projeto original do.NET Framework 3.5 Client Profile, os destinos do projeto atualizado do.NET Framework 3.5.

.NET Framework 2.0

.NET Framework 3.5

.NET Framework 4

.NET Framework 4

ObservaçãoObservação
Se os destinos do projeto original do.NET Framework 3.5 Client Profile, os destinos do projeto atualizado do .NET Framework 4 Client Profile.

Quando você direcionar o .NET Framework 4 em um projeto do Office, você pode usar certos recursos que não estão disponíveis quando você direciona o.NET Framework 3.5. For more information, see Projetando e criando soluções do Office.

Assembly References

Visual Studio atualiza as seguintes referências de assembly no projeto:

Visual Studio não adicionar referências para as versões novas ou atualizadas de módulos (assemblies) que você adicionou ao projeto original depois que ele foi criado. Por exemplo, se você atualizar um Word 2003 add-in do projeto que também faz referência ao assembly de interoperabilidade primário do PowerPoint 2003, o Visual Studio modifica o projeto atualizado para referenciar o Word 2007 ou Word 2010 assembly de interoperabilidade primário. No entanto, você deve atualizar manualmente a referência para o assembly de interoperabilidade primária do PowerPoint.

Atualizando projetos de 2003 do Microsoft Office

Por padrão, se Microsoft Office 2010 ou o sistema de Microsoft Office de 2007 está instalado no computador de desenvolvimento, quando você atualiza um projeto que visa 2003 de Microsoft Office, Visual Studio modifica o projeto de Microsoft Office você instalou a versão de destino. O sempre atualizar para a versão instalada do Office caixa de seleção de Atualizar o projeto página de opções controla esse comportamento. Se você desmarcar essa caixa de seleção, Visual Studio não modifica o projeto de destino Microsoft Office 2010 ou o sistema de Microsoft Office de 2007 e você não poderá abrir, depurar, ou executar o projeto. For more information about this option, see Atualização, a caixa de diálogo Opções de projeto..

Existem algumas considerações adicionais para atualizar as personalizações em nível de documento e o nível de aplicativo suplementos que 2003 de Microsoft Office de destino.

Projetos de nível de documento

Para atualizar um projeto de nível de documento para 2003 de Microsoft Office, você deve ter o apropriado Microsoft Office 2010 ou o aplicativo de sistema de Microsoft Office de 2007 instalado no computador de desenvolvimento. Por exemplo, você deve instalar o Word 2007 ou Word 2010 no computador antes de atualizar um projeto no Word 2003.

Quando você atualiza um projeto de nível de documento com um documento é salvo em um formato binário, você deve decidir se deseja converter o documento em um formato XML aberto, ou para manter o documento em um formato binário. Você deve selecionar XML aberto, a menos que tenha um motivo específico para usar o formato mais antigo. Para obter mais informações sobre o Open XML, consulte Introdução às novas extensões de nome de arquivo e os formatos XML abertos do.

Se o documento do projeto contém controles Windows Forms, você também deve ter as ferramentas de 2005 Visual Studio para Office segundo Edition Runtime instalado antes de atualizar o projeto. Se esta versão do runtime não estiver instalado no computador de desenvolvimento antes de atualizar o projeto, pode haver compilar ou erros de tempo de execução no projeto atualizado. Depois de atualizar o projeto, é possível desinstalar as ferramentas de 2005 Visual Studio para Office segundo Edition Runtime do computador de desenvolvimento se não estiver sendo usado por outras soluções do Office. Esta versão do tempo de execução está disponível como um pacote redistribuível do Centro de Download da Microsoft em Microsoft Visual Studio 2005 Tools for Office segundo Edition Runtime (VSTO 2005 SE) (x86).

Projetos de nível de aplicativo

Se o arquivo de solução para o seu projeto original incluído um projeto de instalação que foi configurado para instalar o suplemento em nível de aplicativo, Visual Studio atualiza o projeto de instalação para uma Visual Studio 2010 o projeto, mas ele não faz mais alterações no projeto. Se você quiser continuar usando um arquivo do Windows Installer para implantar seu suplemento, você deve modificar o projeto de instalação para instalar os pré-requisitos de novos, como o .NET Framework 4 ou.NET Framework 3.5, o Visual Studio 2010 Tools for Office Runtimee opcionalmente primary interop assemblies referenciados pelo seu add-in. For more information, see Implantar uma solução Office usando o Windows Installer.

Se você quiser usar o ClickOnce para implantar seu suplemento, você pode excluir o projeto de instalação totalmente. Para obter mais informações sobre como implantar o add-ins usando ClickOnce, consulte Implantar soluções do Office.

Consulte também

Tarefas

Como: Atualizar soluções do Office

Referência

Atualização, a caixa de diálogo Opções de projeto.

Conceitos

Migrando soluções do Office para o.NET Framework 4