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 de PIAs adicionais (por exemplo, se você deseja 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 assemblies de interoperabilidade primária, consulte Assemblies de Interoperabilidade Primários.
Separe os Assemblies de interoperabilidade primária para a criação e execução de 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 esses assemblies automaticamente.
The global assembly cache.
Essas cópias dos assemblies usadas durante algumas tarefas de desenvolvimento, como, por exemplo, quando você executa ou depurar projetos que visam o.NET Framework 3.5. 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 as diferentes versões dos PIAs sã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 Studio Tools para Office\PIA\Office12
(ou % %\Microsoft de arquivos de programas (x86) Visual Studio 10.0\Visual Studio Tools for Office\PIA\Office12 nos sistemas operacionais de 64 bits)
%ProgramFiles%\Microsoft Visual Studio 10.0\Visual Studio Tools para Office\PIA\Office14
(ou % %\Microsoft de arquivos de programas (x86) 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. For more information, see Configurando um computador para desenvolver soluções do Office.
Computadores de usuários finais também devem ter os PIAs para executar esse destino de soluções do Office instalado e registrado no cache global de assemblies do.NET Framework 3.5. No entanto, os PIAs do Office não são necessárias em computadores de usuários finais para executar o Office solutions destinados a .NET Framework 4. For more information, see 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 tenha um projeto 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 de Office\PIA\. Estas versões dos assemblies aparecem na .NET guia de Add Reference caixa de diálogo. For more information, see 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, essas versões dos assemblies aparecem na COM guia da Add Reference caixa de diálogo. Você deve evitar adicionar referências para essas versões de assemblys, porque existem algumas questões de desenvolvimento que podem ocorrer quando você usá-los. Por exemplo, se você tiver registrado 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.
.gif "Observação") 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 Microsoft Office 2010 e o sistema de Microsoft Office de 2007.
Aplicativo do Office ou componente |
Nome do assembly de interoperabilidade primária |
|---|---|
Biblioteca de objetos do Microsoft Access 12.0 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 do Access Microsoft Office 14.0 |
Microsoft.Office.Interop.Access.DAO.dll |
Biblioteca de objetos do Microsoft Excel 12.0 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 do 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 |
Biblioteca de objetos do Microsoft Outlook 12.0 Biblioteca de objetos do Microsoft Outlook 14.0 |
Microsoft.Office.Interop.Outlook.dll |
Biblioteca de objetos do Microsoft PowerPoint 12.0 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.For more information, see Visão geral sobre marcas inteligentes.
|
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 |
Microsoft Visio 12.0 Salvar como a biblioteca de tipos de Web Microsoft Visio 14.0 Salvar como a 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 |
Biblioteca de objetos do Microsoft Word 12.0 Biblioteca de objetos do Microsoft Word 14.0 |
Microsoft.Office.Interop.Word.dll |
De Visual Basic for Applications Microsoft Extensibility 5.3 |
Microsoft.VBE.Interop.dll |
Assemblies de redirecionamento de ligação
Quando você instala e registra os PIAs do Office no global assembly cache (ou com o Office ou instalando o 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 certificar-se de que a versão correta de assemblies de interoperabilidade primários são carregados em tempo de execução. Por exemplo, quando uma solução que referencia um assembly de interoperabilidade primária do Microsoft Office da 2007 é executado em um computador que tenha a Microsoft 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 Microsoft Office 2010 versão do assembly de interoperabilidade primário. For more information, see 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, por exemplo, 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
Visão geral do modelo de objeto do Visio
Outros recursos
Visão geral do modelo de objeto do Excel
Visão geral do modelo de objeto do Outlook
Palavra Overview do modelo de objeto
Referência de geral (desenvolvimento do Office em Visual Studio)