Compartilhar via

Aplicativos do Office de destino por meio de assemblies de interoperabilidade primários

  • Artigo

Quando você cria um novo projeto do Office, o Visual Studio adiciona automaticamente referências aos assemblies de interoperabilidade primária (PIAs) do Microsoft Office que são necessários para criar seu projeto. Você deve adicionar referências a outros PIAs nos seguintes cenários:

  • Você deseja usar recursos de outros aplicativos do Microsoft Office em seu projeto. Por exemplo, talvez você queira usar recursos do Microsoft Office Excel em um projeto para o Microsoft Office Word.

  • Você deseja automatizar aplicativos do Microsoft Office que não têm projetos dedicados no Visual Studio, como o Microsoft Office Access.

    Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de suplemento VSTO. Consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

    Observação

    Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE.

Para adicionar uma referência a um assembly de interoperabilidade primário

  1. Abra seu projeto do Office e selecione o nome do projeto no Gerenciador de Soluções.

  2. No menu Projeto, clique em Adicionar Referência.

  3. Na guia Estrutura, selecione o PIA desejado na lista Nome do componente. Para obter mais informações sobre os assemblies de interoperabilidade primária do Microsoft Office disponíveis, consulte Assemblies de interoperabilidade primária do Office.

    Se o projeto tiver como alvo o .NET Framework 4 ou posterior, a propriedade Embed Interop Types para a referência de assembly será definida como True por padrão. Usando essa configuração, sua solução não requer o PIA em computadores de usuário final. Para obter mais informações, consulte Projetar e criar soluções do Office.

    Observação

    Em projetos do Office, sempre adicione referências a PIAs do Office usando a guia .NET da caixa de diálogo Adicionar Referência em vez da guia COM. Para obter mais informações, consulte Assemblies de interoperabilidade primária do Office.

  4. Clique em OK.

    O nome do assembly aparece na pasta Referências do Gerenciador de Soluções.

Conteúdo relacionado