Compartilhar via

Conjuntos de interoperabilidade primária do Office

Para utilizar os recursos de um aplicativo do Microsoft Office de um projeto do Office, é necessário usar o assembly de interoperabilidade principal (PIA) para o aplicativo. O PIA permite que o código gerenciado interaja com o modelo de objeto baseado em COM de um aplicativo do Microsoft Office.

Observação

Interessado em desenvolver soluções que estendam a experiência do Office em várias plataformas? Confira o novo modelo de Suplementos do Office. Os complementos do Office têm um menor impacto em comparação com complementos e soluções VSTO, e você pode criá-los usando quase qualquer tecnologia de programação da web, como HTML5, JavaScript, CSS3 e XML.

Quando você cria um novo projeto do Office, o Visual Studio adiciona referências aos PIAs necessários para criar o projeto. Em alguns cenários, talvez seja necessário adicionar referências a outros PIAs (por exemplo, você pode usar um recurso do Microsoft Office Word em um projeto para o Microsoft Office Excel).

Este artigo descreve os seguintes aspectos do uso dos PIAs do Microsoft Office em projetos do Office:

Para obter mais informações sobre assemblies de interoperabilidade primários, consulte assemblies de interoperabilidade primários.

Separar assemblies de interoperabilidade primários para compilar e executar projetos

O Visual Studio usa diferentes conjuntos de PIAs no computador de desenvolvimento. Esses diferentes conjuntos de módulos estão localizados nos seguintes locais:

  • Uma pasta no diretório de arquivos do programa

    Esse conjunto de assemblies é usado quando você escreve códigos e compila projetos. O Visual Studio instala esses assemblies automaticamente.

  • O cache global de assembly

    Esse conjunto de assemblies é usado durante algumas tarefas de desenvolvimento, como quando você executa ou depura projetos. O Visual Studio não instala e registra esses assemblies; você precisa fazer isso por conta própria.

Assemblies de interoperabilidade primários no diretório de arquivos do programa

Os PIAs são adicionados automaticamente a um local no sistema de arquivos, fora do cache de assembly global, durante a instalação do Visual Studio. Quando você cria um novo projeto, o Visual Studio adiciona automaticamente referências a essas cópias dos PIAs ao seu projeto. O Visual Studio usa essas cópias dos PIAs, em vez dos assemblies no cache de assembly global, para solucionar referências de tipo ao desenvolver e compilar seu projeto.

Quando diferentes versões dos PIAs são registradas no cache de assemblies global, podem surgir várias questões de desenvolvimento. As cópias adicionadas de PIAs ajudarão você a evitar esses problemas.

Para o Visual Studio 2017 e posterior, essas cópias dos PIAs são instaladas nos seguintes locais compartilhados no computador de desenvolvimento:

  • %ProgramFiles%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\

  • (ou %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ em sistemas operacionais de 64 bits)

Observação

Para versões mais antigas do Visual Studio, esses PIAs serão instalados na pasta Visual Studio Tools para Office\PIA dentro da pasta %ProgramFiles% para aquela versão do Visual Studio. Por exemplo: %ProgramFiles(x86)%\Microsoft Visual Studio 14.0\Visual Studio Tools for Office\PIA\

Assemblies de interoperabilidade primários no cache de assemblies global

Para executar determinadas tarefas de desenvolvimento, os PIAs devem ser instalados e registrados no cache global de assembly no computador utilizado para desenvolvimento. Normalmente, os PIAs são instalados automaticamente quando você instala o Office no computador de desenvolvimento. Para obter mais informações, consulte Configurar um computador para desenvolver soluções do Office.

Os PIAs do Office não são necessários em computadores de usuário final para executar soluções do Office. Para obter mais informações, consulte Design e crie soluções do Office.

Usar recursos de vários aplicativos do Microsoft Office em um único projeto

Cada modelo de projeto do Office no Visual Studio foi projetado para funcionar com um único aplicativo do Microsoft Office. Para usar recursos em vários aplicativos do Microsoft Office ou usar recursos em um aplicativo ou componente que não tenha um projeto no Visual Studio, você deve adicionar uma referência aos PIAs necessários.

Na maioria dos casos, você deve adicionar referências aos PIAs instalados pelo Visual Studio no %ProgramFiles(x86)%\Microsoft Visual Studio\Shared\Visual Studio Tools for Office\PIA\ diretório. Essas versões dos assemblies aparecem na guia Estrutura da caixa de diálogo Gerenciador de Referência . Para obter mais informações, consulte Como direcionar aplicativos do Office por meio de assemblies de interoperabilidade primários.

Se você instalou e registrou os PIAs no cache de assembly global, essas versões dos assemblies aparecerão na guia COM da caixa de diálogo Gerenciador de Referências. Evite adicionar referências a essas versões dos assemblies, pois há alguns problemas de desenvolvimento que podem ocorrer quando você as usa. Por exemplo, se você registrou diferentes versões dos PIAs no Cache de Assembly Global, seu projeto será automaticamente associado à versão do assembly que foi registrada por último, mesmo que você especifique uma versão diferente do assembly na guia COM da caixa de diálogo Gerenciador de Referências.

Observação

Alguns assemblies são adicionados a um projeto automaticamente quando um assembly que faz referência a eles é adicionado. Por exemplo, as referências aos assemblies Office.dll e Microsoft.Vbe.Interop.dll são adicionadas automaticamente quando você adiciona uma referência aos assemblies Word, Excel, Outlook, Microsoft Forms ou Graph.

Assemblies de interoperabilidade primárias para aplicativos do Microsoft Office

A tabela a seguir lista os assemblies de interoperabilidade primários disponíveis para o Office 2016, Office 2013 e Office 2010.


Aplicativo ou componente do Office Nome do assembly de interoperabilidade primário
Biblioteca de objetos do Microsoft Access 14.0

Biblioteca de objetos do Microsoft Access 15.0		 Microsoft.Office.Interop.Access.dll
Biblioteca de objetos do Mecanismo de Banco de Dados do Access do Microsoft Office 14.0

Biblioteca de objetos do Mecanismo de Banco de Dados do Microsoft Office 15.0 Access		 Microsoft.Office.Interop.Access.Dao.dll
Biblioteca de objetos do Microsoft Excel 14.0

Biblioteca de objetos do Microsoft Excel 15.0		 Microsoft.Office.Interop.Excel.dll
Biblioteca de Objetos do Microsoft Graph 14.0 (usada pelo PowerPoint, Access e Word para grafos)

Biblioteca de objetos do Microsoft Graph 15.0		 Microsoft.Office.Interop.Graph.dll
Biblioteca de tipos do Microsoft InfoPath 2.0 (somente para InfoPath 2007) Microsoft.Office.Interop.InfoPath.dll
Assembly de interoperabilidade XML do Microsoft InfoPath (somente para InfoPath 2007) Microsoft.Office.Interop.InfoPath.Xml.dll
Biblioteca de Objetos do Microsoft Office 14.0 (funcionalidade compartilhada do Office)

Biblioteca de Objetos do Microsoft Office 15.0 (funcionalidade compartilhada do Office)		 office.dll
Controle de Exibição do Microsoft Office Outlook (pode ser usado em páginas da Web e aplicativos para acessar sua Caixa de Entrada) Microsoft.Office.Interop.OutlookViewCtl.dll
Biblioteca de objetos do Microsoft Outlook 14.0

Biblioteca de objetos do Microsoft Outlook 15.0		 Microsoft.Office.Interop.Outlook.dll
Biblioteca de objetos do Microsoft PowerPoint 14.0

Biblioteca de objetos do Microsoft PowerPoint 15.0		 Microsoft.Office.Interop.PowerPoint.dll
Biblioteca de objetos do Microsoft Project 14.0

Biblioteca de objetos do Microsoft Project 15.0		 Microsoft.Office.Interop.MSProject.dll
Biblioteca de Objetos do Microsoft Publisher 14.0

Biblioteca de objetos do Microsoft Publisher 15.0		 Microsoft.Office.Interop.Publisher.dll
Biblioteca de referência de objeto Web do Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesigner.dll
Biblioteca de referência de objeto de página do Microsoft SharePoint Designer 14.0 Microsoft.Office.Interop.SharePointDesignerPage.dll
Microsoft Smart Tags 2.0 Type Library Observação: marcas inteligentes são preteridas no Excel 2010 e Word 2010. Microsoft.Office.Interop.SmartTag.dll
Biblioteca de Tipos do Microsoft Visio 14.0

Biblioteca de Tipos do Microsoft Visio 15.0		 Microsoft.Office.Interop.Visio.dll
Biblioteca do Microsoft Visio 14.0 Salvar Como Tipo Web

Biblioteca salvar como tipo da Web do Microsoft Visio 15.0		 Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Biblioteca de tipos de controle de desenho do Microsoft Visio 14.0

Biblioteca de tipos de controle de desenho do Microsoft Visio 15.0		 Microsoft.Office.Interop.VisOcx.dll
Biblioteca de objetos do Microsoft Word 14.0

Biblioteca de objetos do Microsoft Word 15.0		 Microsoft.Office.Interop.Word.dll
Microsoft Visual Basic for Applications Extensibility 5.3 Microsoft.Vbe.Interop.dll

Associar assemblies de redirecionamento

Quando você instala e registra os PIAs do Office no cache de assembly global (com o Office ou instalando o pacote redistribuível para os PIAs), os assemblies de redirecionamento de associação também são instalados apenas no cache de assembly global. Esses assemblies garantem que a versão correta das bibliotecas de interoperabilidade primárias seja carregada em tempo de execução.

Por exemplo, quando uma solução que faz referência a um assembly do Office 2010 é executada em um computador com a versão do Office 2013 do mesmo assembly de interoperabilidade primário, o assembly de redirecionamento de associação instrui o runtime do .NET Framework a carregar a versão do Office 2013 do assembly de interoperabilidade primário.

Para obter mais informações, consulte Como habilitar e desabilitar o redirecionamento automático de associação.

Conteúdo relacionado

  • Last updated on