Atualizando e migrando soluções do Office

Artigo
02/25/2013

Se você tiver um projeto Microsoft Office que é criado em uma versão anterior do Visual Studio, você deve atualizar o projeto usá-lo em Visual Studio 2012.Para atualizar um projeto Microsoft Office, abra-o em uma versão de Visual Studio 2012 que inclui as ferramentas do desenvolvedor 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 versões de Visual Studio 2012 que incluem as ferramentas do desenvolvedor do Microsoft Office, consulte Configurando um computador para desenvolver soluções do Office.

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

Observação
Visual Studio 2012 não pode atualizar projetos do modelo de formulário de InfoPath que foram criados usando versões anteriores do Visual Studio.Esses tipos de projetos não são suportados em Visual Studio 2012.

Versões compatíveis de atualização de O

Você pode atualizar projetos do Office criados usando quaisquer das seguintes versões de ferramentas do Office no Visual Studio.

Microsoft Visual Studio 2005 ferramentas para o Microsoft Office system.
Microsoft Visual Studio 2005 ferramentas para 2007 Microsoft Office system (SE VSTO de 2005).
Ferramentas do Microsoft Visual Studio para o Microsoft Office system (versão 3,0).Esta versão do Visual Studio para Office foi incluída no Visual Studio 2008.
Ferramentas do desenvolvedor do Microsoft Office no Visual Studio 2010.

Visual Studio 2012 não suporta atualizar os projetos Microsoft Office criados usando Visual Studio para Office, versão 2003.Para continuar a desenvolver um desses projetos em Visual Studio 2012, crie um novo projeto do Office e mover manualmente o código no novo projeto.

Observação
OVisual Studio para Office foi o nome das ferramentas do desenvolvedor do Microsoft Office em versões anteriores do Visual Studio.

Alterações em projetos atualizados

Quando você atualiza um projeto Microsoft Office, o Visual Studio altera o projeto para os seguintes itens:

O 2010 Visual Studio Tools for Office Runtime.Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.
Uma versão do.NET Framework que é suportada pelo tipo de projeto.
Uma versão do Microsoft Office que é suportada pelo tipo de projeto.
As referências atual do assembly.

O .NET Framework de destino

Quando você atualiza um projeto em Visual Studio 2012, o Visual Studio altera o projeto para .NET Framework 4..NET Framework 4 está instalado automaticamente quando você instala Visual Studio 2012.

Se você instalar as ferramentas do desenvolvedor do Microsoft Office para Visual Studio 2012 e atualiza em um projeto em Visual Studio 2012, o Visual Studio altera o projeto para .NET Framework 4.5.As soluções do Office podem focar .NET Framework 4.5 somente se você instalar as ferramentas do desenvolvedor do Microsoft Office para Visual Studio 2012.Para obter mais informações, consulte” Página de downloadno “ferramentas.

Observação
Talvez você precise executar algumas etapas adicionais para executar uma solução retargeted desenvolvimento e nos computadores de usuário final, e seu projeto não irá criar usar determinados recursos.Para obter mais informações, consulte Migrando soluções do Office para o .NET Framework 4 ou o .NET Framework 4.5.

Se você tem como alvo .NET Framework 4 ou .NET Framework 4.5 em um projeto do Office, você pode usar quaisquer recursos que não estão disponíveis quando você utiliza o .NET Framework 3.5.Para obter mais informações, consulte Projetando e criando soluções do Office.

Aplicativo de destino do Office

Quando você atualiza um projeto do Office, o Visual Studio altera o projeto para direcionar uma versão do Microsoft Office que é suportada pelo tipo de projeto, como um projeto de personalização de um documento ou nível o projeto do suplemento ao aplicativo.

Os projetos do Office em Visual Studio 2012 podem selecionar somente Office 2013 e aplicativos de Office 2010 .Se Office 2013 é instalado, Visual Studio altera o projeto para Office 2013.Se Office 2010 é instalado, Visual Studio altera o projeto para Office 2010.Se nenhuma versão do Office estiver instalado, Visual Studio 2012 não atualiza o projeto.

Observação
Se você atualizar um projeto do suplemento direcionar Office 2013, certifique-se de que o manipulador de eventos de ThisAddIn_Startup do suplemento não contém o código que acessa um documento no aplicativo.Para obter mais informações, consulte Accessing a Document when the Office Application Starts.

Para personalizações da nível, Visual Studio converte os documentos em um projeto que têm um formato binário, como documentos que têm uma extensão de .xls ou .doc, o formato de abertura do Office XML.Para obter mais informações sobre XML aberto, consulte Introdução às novas extensões de nome de arquivo e os formatos abertos XML.

Observação
Marcas inteligentes são substituídas no Excel 2010 e no Word 2010.Como consequência, se sua solução usa marcas inteligentes, você deve removê-los antes que você possa a testar e depurar em Visual Studio 2012.

Referências de Assembly

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

Assemblies de interoperabilidade primários (PIAs) Microsoft Office.
Assemblies em Visual Studio Tools for Office Runtime.Para obter mais informações sobre esses assemblies, consulte o Visual Studio Tools for Office visão geral sobre o tempo de execução.
Novo ou versões atualizadas de assemblies dependentes.

Visual Studio não adicionar referências a nova ou versões atualizadas dos assemblies que você adicionou ao projeto original depois que foi criado.Por exemplo, se você atualizar um projeto 2003 do suplemento ao Word que o Powerpoint 2003 também referencia assemblies de interoperabilidade primários, o Visual Studio altera o projeto atualizado referenciar o assembly de interoperabilidade primária de Word 2010 .No entanto, você deve atualizar manualmente a referência ao assembly de interoperabilidade primário do Powerpoint.

Atualização Microsoft Office 2003 projetos

Há algumas considerações adicionais para atualizar as personalizações da nível e suplementos nível de aplicativo que direcionam o Microsoft Office 2003.

Projetos de um documento nível

Se o documento no projeto contém controles de formulários do Windows, você também deve ter as ferramentas do Visual Studio 2005 para o tempo de execução do Office segundo instalado antes que você atualize o projeto.Se esta versão do runtime não está instalado no computador de desenvolvimento antes que você atualize o projeto, o projeto atualizado pode conter compila ou erros de tempo de execução.Depois que você concluir atualizar o projeto, você poderá desinstalar as ferramentas do Visual Studio 2005 para o tempo de execução do Office dependendo do computador de desenvolvimento se não está sendo usado por outras soluções do Office.Esta versão do runtime está disponível como um pacote redistribuível do Microsoft Download Center em Microsoft Visual Studio 2005 ferramentas para o tempo de execução do Office (dependendo SE 2005 de VSTO (x)).

Projetos de nível de aplicativo

Se o arquivo de solução para o projeto original incluiu uma configuração ou um projeto de edição limitada de InstallShield que são configurados para instalar o suplemento ao aplicativo, o Visual Studio atualizar o projeto para um projeto de Visual Studio 2012 , mas não faz para promover alterações ao projeto.Se você deseja manter usando um arquivo do Windows Installer para implantar seu suplemento, você deve alterar a configuração ou projeto de edição limitada de InstallShield instalar novos condições prévias como .NET Framework 4, o 2010 Visual Studio Tools for Office Runtime, e opcionalmente assemblies de interoperabilidade primários referenciados pelo suplemento.Para obter mais informações, consulte Implantando uma solução do Office usando o Windows Installer.

Se você desejar usar o ClickOnce para implantar seu suplemento, você pode excluir a configuração ou projeto de edição limitada de InstallShield inteiramente.Para obter mais informações sobre como implantar suplementos usando o ClickOnce, consulte Implantando uma solução do Office.

Consulte também

Compartilhar via