Assemblies de interoperabilidade primária do Office

Para usar os recursos de um aplicativo de Microsoft Office de um projeto do Office, você deve usar o assembly de interoperabilidade primária (PIA) para o aplicativo.O PIA permite que o código gerenciado interagir com o modelo de objeto baseado em COM de um aplicativo Microsoft Office.

Quando você cria um novo projeto do Office, o Visual Studio adiciona referências para os PIAs que são necessárias para construir o projeto.Em alguns cenários, talvez você precise adicionar referências para PIAs adicionais (por exemplo, se você desejar usar um recurso do Word de Microsoft Office em um projeto para o Excel de Microsoft Office).

Este tópico descreve os seguintes aspectos da usando os PIAs de Microsoft Office em projetos do Office:

• Assemblies de interoperabilidade primários separados para criar e executar projetos

• Usando os recursos de vários aplicativos de Microsoft Office em um único projeto.

• Lista completa de assemblies de interoperabilidade primária para aplicativos de Microsoft Office

Para obter mais informações sobre módulos de interoperabilidade primários, consulte Assemblies de interoperabilidade primários.

Separe os Assemblies de interoperabilidade primária para criar e executar projetos

Visual Studio usa conjuntos diferentes dos PIAs no computador de desenvolvimento.Esses diferentes conjuntos de módulos (assemblies) estão nos seguintes locais:

• Uma pasta no diretório de arquivos de programa.

  Essas cópias dos assemblies são usadas quando você escreve o código e construir projetos.Visual Studio instala automaticamente esses assemblies.

• O cache global de assemblies

  Essas cópias dos assemblies são usadas durante algumas tarefas de desenvolvimento, como, por exemplo, quando você executa ou depurar projetos.Visual Studio não instalar e registrar esses assemblies; Você deve fazer isso sozinho.

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

Quando você instala o Visual Studio, os PIAs são instalados automaticamente para um local no sistema de arquivos fora do cache global de assemblies.Quando você cria um novo projeto, o Visual Studio adiciona automaticamente referências a essas cópias dos PIAs ao seu projeto.Visual Studio usa essas cópias dos PIAs, em vez dos assemblies no cache global de assemblies, para resolver referências de tipo quando você desenvolver e construir seu projeto.

Essas cópias dos PIAs evitar Visual Studio diversos problemas de desenvolvimento que podem ocorrer quando diferentes versões dos PIAs estão registradas no cache global de assemblies.

Visual Studio instala essas cópias dos PIAs nos seguintes locais no computador de desenvolvimento:

• %ProgramFiles%\Microsoft Visual Studio 10.0\Visual o Studio Tools para Office\PIA\Office12

  (ou % ProgramFiles (x86) %\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office12 nos sistemas operacionais de 64 bits)

• %ProgramFiles%\Microsoft Visual Studio 10.0\Visual o Studio Tools para Office\PIA\Office14

  (ou % ProgramFiles (x86) %\Microsoft Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office14 nos sistemas operacionais de 64 bits)

Assemblies de interoperabilidade primários no Cache Global de assemblies

Para executar determinadas tarefas de desenvolvimento, os PIAs devem ser instalados e registrados no global assembly cache no computador de desenvolvimento.Normalmente, os PIAs são instalados automaticamente quando você instala o Office no computador de desenvolvimento.Para mais informações, consulte Configurando 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 as soluções do Office.Para mais informações, consulte Projetando e criando soluções do Office.

Usando os recursos de vários aplicativos de Microsoft Office em um único projeto.

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

Na maioria dos casos, você deve adicionar referências para os PIAs instalados pelo Visual Studio sob o %ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools para o diretório Office\PIA\.Estas versões dos assemblies aparecem na .NET guia da Add Reference caixa de diálogo.Para mais informações, consulte Como: aplicativos do Office de destino por meio de Assemblies de interoperabilidade primários.

Se você tiver instalado e registrado os PIAs no cache global de assemblies, estas versões dos assemblies aparecem na COM guia da Add Reference caixa de diálogo.Você deve evitar a adição de referências a essas versões dos assemblies, porque existem algumas questões de desenvolvimento que podem ocorrer quando você usá-los.Por exemplo, se você registrou diferentes versões dos PIAs no cache global de assemblies, seu projeto fará automaticamente a ligação para a versão do assembly que foi registrado pela última vez — mesmo se você especificar uma versão diferente do assembly na COM guia da Add Reference caixa de diálogo.

Observação
Alguns módulos (assemblies) é adicionados automaticamente a um projeto quando é adicionado a um assembly que referências a eles.Por exemplo, referências aos assemblies Office. dll e Microsoft.Vbe.Interop.dll são adicionadas automaticamente quando você adiciona uma referência para os assemblies do Word, Excel, Outlook, o Microsoft Forms ou gráfico.

Assemblies de interoperabilidade primária para aplicativos de Microsoft Office

A tabela a seguir lista os assemblies de interoperabilidade primária que estão disponíveis para Office 2010 e o sistema de Microsoft Office de 2007.

Aplicativo do Office ou componente	Nome do assembly de interoperabilidade primária
Microsoft Access 12.0 Object Library Biblioteca de objetos do Microsoft Access 14.0	Microsoft.Office.Interop.Access.dll
Biblioteca de objetos Microsoft Office 2007 Access banco de dados do mecanismo Biblioteca de objeto do mecanismo de banco de dados Access Microsoft Office 14.0	Microsoft.Office.Interop.Access.DAO.dll
O Microsoft Excel 12.0 Object Library Biblioteca de objetos do Microsoft Excel 14.0	Microsoft.Office.Interop.Excel.dll
Microsoft Graph 12.0 Object Library (para gráficos, usado pelo Word, Access e PowerPoint) Biblioteca de objetos Microsoft Graph 14.0	Microsoft.Office.Interop.Graph.dll
Biblioteca de tipos do Microsoft InfoPath 2.0 (para o InfoPath 2007 apenas)	Microsoft.Office.Interop.InfoPath.dll
Assembly de interoperabilidade do XML do Microsoft InfoPath (para o InfoPath 2007 apenas)	Microsoft.Office.Interop.InfoPath.XML.dll
Microsoft Office 12.0 Object Library (funcionalidade compartilhado do Office) Biblioteca de objetos Microsoft Office 14.0 (funcionalidade compartilhado do Office)	Office. dll
Controle de exibição de Microsoft Office Outlook (pode ser usado em páginas da Web e aplicativos para acessar sua caixa de entrada)	Microsoft.Office.Interop.OutlookViewCtl.dll
O Microsoft Outlook 12.0 Object Library Biblioteca de objetos do Microsoft Outlook 14.0	Microsoft.Office.Interop.Outlook.dll
O Microsoft PowerPoint 12.0 Object Library Biblioteca de objetos do Microsoft PowerPoint 14.0	Microsoft.Office.Interop.PowerPoint.dll
Biblioteca de objetos do Microsoft Project 12.0 Biblioteca de objetos do Microsoft Project 14.0	Microsoft.Office.Interop.MSProject.dll
O Microsoft Publisher 12.0 Object Library Biblioteca de objetos do Microsoft Publisher 14.0	Microsoft.Office.Interop.Publisher.dll
Biblioteca de referência de objeto Web do Microsoft SharePoint Designer 12.0 Biblioteca de referência de objeto Web do Microsoft SharePoint Designer 14.0	Microsoft.Office.Interop.SharePointDesigner.dll
Biblioteca de referência de objeto Page do Microsoft SharePoint Designer 12.0 Biblioteca de referência de objeto Page do Microsoft SharePoint Designer 14.0	Microsoft.Office.Interop.SharePointDesignerPage.dll
Biblioteca de tipos do Microsoft Smart Tags 2.0 Observação As marcas inteligentes estão obsoletas no Excel 2010 e Word 2010.	Microsoft.Office.Interop.SmartTag.dll
Biblioteca de tipos do Microsoft Visio 12.0 Biblioteca de tipos do Microsoft Visio 14.0	Microsoft.Office.Interop.Visio.dll
O Microsoft Visio 12.0 Salvar como biblioteca de tipos de Web O Microsoft Visio 14.0 Salvar como biblioteca de tipos de Web	Microsoft.Office.Interop.Visio.SaveAsWeb.dll
Biblioteca de tipos de controle de desenho do Microsoft Visio 12.0 Biblioteca de tipos de controle de desenho do Microsoft Visio 14.0	Microsoft.Office.Interop.VisOcx.dll
Microsoft Word 12.0 Object Library Biblioteca de objetos do Microsoft Word 14.0	Microsoft.Office.Interop.Word.dll
De Visual Basic for Applications Microsoft extensibilidade 5.3	Microsoft.VBE.Interop.dll

Assemblies de redirecionamento de ligação

Quando você instala e registra os PIAs do Office no cache global de assemblies (ou com o Office ou pela instalação do pacote redistribuível para os PIAs), os assemblies de redirecionamento de ligação também são instalados somente no cache global de assemblies.Esses assemblies ajudam a tornar-se de que a versão correta do assemblies de interoperabilidade primários sejam carregados em tempo de execução.Por exemplo, quando uma solução que referencia um 2007 Microsoft Office assembly de interoperabilidade primária é executado em um computador que tenha a Office 2010 o conjunto de redirecionamento de ligação de versão do mesmo assembly de interoperabilidade primário, instrui o .NET Framework runtime para carregar o Office 2010 versão do assembly de interoperabilidade primária.Para mais informações, consulte Redirecionamento de ligação de assembly.

Cada assembly de redirecionamento de ligação tem um nome no formato Policy.11.0. Nome PIA. dll ou Policy.12.0. Nome PIA. dll, como Policy.11.0.Microsoft.Office.Interop.Excel.dll e Policy.12.0.Microsoft.Office.Interop.Excel.dll.

Consulte também

Tarefas

Como: aplicativos do Office de destino por meio de Assemblies de interoperabilidade primários

Conceitos

Soluções do InfoPath

Soluções de PowerPoint

Soluções de projeto

Visão geral do modelo de objeto do Visio

Outros recursos

Visão geral sobre o modelo de objeto do Excel

Visão geral sobre o modelo de objeto do Outlook

Visão geral do modelo de objeto do Word

Referência geral (desenvolvimento do Office em Visual Studio)