Projetar e criar soluções do Office

  • Artigo

Visual Studio fornece modelos de projeto que você pode usar para criar vários tipos diferentes de soluções do Office. Esta seção da documentação descreve os modelos de projeto e fornece orientação sobre como criar projetos do Office. Para obter informações sobre como implementar personalizações de código e interface do usuário depois de criar seu projeto, consulte Desenvolver soluções do Office.

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

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 Suplementos do Office têm um espaço pequeno em comparação com os suplementos e soluções VSTO, e você pode criá-los usando praticamente qualquer tecnologia de programação da Web, como HTML5, JavaScript, CSS3 e XML.

Criar projetos do Office

Antes de começar, você deve determinar seus requisitos e descobrir o tipo de solução que oferece o melhor ajuste. Por exemplo, se sua solução do Office precisar ser executada sempre que o aplicativo for usado, um suplemento VSTO atenderá melhor às suas necessidades. Se o código estiver totalmente integrado a um único documento, crie uma personalização em nível de documento. Esses tipos de projeto estão disponíveis como modelos de projeto do Visual Studio. Para obter mais informações sobre os modelos de projeto do Office incluídos no Visual Studio, consulte Visão geral sobre modelos de projeto do Office. Para obter mais informações sobre como criar projetos do Office, consulte Como: Criar projetos do Office no Visual Studio.

Projetos do Office têm recursos e itens de projeto que são diferentes de outros tipos de projetos no Visual Studio. Por exemplo, quando você cria um projeto de nível de documento, o documento ou pasta de trabalho em seu projeto pode ser aberto e editado dentro do Visual Studio. Para obter mais informações, consulte Projetos do Office no ambiente do Visual Studio.

Escolha uma versão do .NET Framework

Depois de selecionar o tipo de projeto que melhor se adapta aos seus requisitos, você pode escolher qual versão do .NET Framework usar em seu processo de desenvolvimento. Você pode direcionar as seguintes versões do .NET Framework em projetos do Office:

  • .NET Framework 4

  • .NET Framework 4 Client Profile

  • .NET Framework 4.5

    A versão do .NET Framework que você escolher para seu projeto é necessária em computadores de usuário final para que sua solução seja executada. Por exemplo, se o seu projeto tem como alvo o .NET Framework 4, o .NET Framework 4 é necessário em computadores de usuário final. Neste exemplo, sua solução não será executada se apenas o .NET Framework 3.5 estiver instalado em computadores de usuário final.

    Se você migrar um projeto de suplemento VSTO destinado ao .NET Framework 3.5, o Visual Studio alterará a estrutura de destino do seu projeto para o .NET Framework 4 ou posterior, dependendo da versão do Office que você instalou.

    No entanto, depois que o Visual Studio altera a estrutura de destino, talvez seja necessário modificar parte do código em seu projeto se ele usar determinados recursos. Para obter mais informações sobre como alterar a estrutura de destino, consulte Como: Direcionar uma versão do .NET Framework. Para obter mais informações sobre as alterações que talvez você precise fazer em seu projeto, consulte Migrar soluções do Office para o .NET Framework 4 ou posterior.

    Se o Visual Studio alterar o .NET Framework de destino para seu projeto e você estiver usando ClickOnce para implantar sua solução, certifique-se de que você também selecione a versão correspondente do .NET Framework na caixa de diálogo Pré-requisitos . Essa seleção não é alterada automaticamente quando você altera a estrutura de destino do seu projeto. Para obter mais informações, consulte Como: Instalar pré-requisitos em computadores de usuário final para executar soluções do Office.

Observação

Você não pode direcionar o .NET Framework 3.5 ou anterior em projetos do Office que você cria usando o Visual Studio 2013. Projetos do Office que você cria usando o Visual Studio 2013 exigem recursos que foram introduzidos pela primeira vez no .NET Framework 4 Client Profile

Entender quando os PIAs do Office são necessários nos computadores dos usuários finais

Por padrão, os assemblies de interoperabilidade primária (PIAs) do Office não precisam ser instalados em computadores de usuário final se a propriedade Embed Interop Types de cada referência do Office PIA no projeto estiver definida como True, que é o valor padrão. Nesse cenário, as informações de tipo para os tipos de PIA que são usados por sua solução são incorporadas no assembly da solução quando você cria o projeto. Em tempo de execução, as informações de tipo incorporado são usadas em vez dos PIAs para chamar o modelo de objeto baseado em COM do aplicativo do Office. Para obter mais informações sobre como os tipos de PIAs são incorporados à sua solução, consulte Equivalência de tipos e tipos de interoperabilidade incorporados.

Se a propriedade Embed Interop Types de cada referência do Office PIA no projeto estiver definida como False, os PIAs do Office deverão ser instalados e registrados no cache de assembly global em cada computador de usuário final que executa a solução. Na maioria dos casos, os PIAs são instalados por padrão com o Office, mas você também pode incluir o PIA redistribuível como um pré-requisito para sua solução. Para obter mais informações, consulte Pré-requisitos de solução do Office para implantação.

Entenda o perfil do cliente

O .NET Framework Client Profile é um subconjunto do .NET Framework completo. Você pode direcionar o .NET Framework Client Profile se precisar usar apenas os recursos de cliente no .NET Framework e desejar fornecer a experiência de implantação mais rápida possível para sua solução do Office. Para obter mais informações, consulte Perfil de cliente do .NET Framework.

Quando você cria um projeto do Office destinado ao .NET Framework 4, o .NET Framework 4 Client Profile é direcionado por padrão. Se você deseja desenvolver para o .NET Framework 4 completo, você deve definir essa opção depois que o projeto é criado. Para obter mais informações, consulte Como direcionar a uma versão do .NET Framework.

Criar soluções para a edição de 64 bits do Microsoft Office

O Microsoft Office está disponível em edições de 64 bits e 32 bits. Para criar soluções do Office que podem ser executadas em qualquer edição, a configuração de destino da plataforma para seu projeto deve ser definida como Qualquer CPU. Esse é o valor padrão para projetos do Office. Para obter mais informações, consulte Criar soluções do Office.

Há versões separadas de 64 bits e 32 bits do tempo de execução do Visual Studio Tools for Office que são usadas pelas edições de 64 bits e 32 bits do Microsoft Office. Para obter mais informações, consulte Visão geral do tempo de execução do Visual Studio Tools for Office.

Montagens em soluções do Office

Quando você cria um projeto do Office usando as ferramentas de desenvolvimento do Office no Visual Studio, o código que você escreve é eventualmente compilado em um assembly. O assembly é implantado em um servidor compartilhado ou em um diretório no computador cliente.

Os assemblies nas soluções do Office são carregados por um aplicativo do Office. Depois que o assembly é carregado, o código no assembly pode responder a eventos que são gerados no aplicativo, por exemplo, quando um usuário clica em um item de menu. O código no assembly também pode chamar o modelo de objeto para automatizar e estender o aplicativo, e ele pode usar qualquer uma das classes no .NET Framework. Para obter mais informações, consulte Arquitetura de personalizações em nível de documento e Arquitetura de suplementos VSTO.

As soluções do Office usam manifestos de implantação e manifestos de aplicativo para identificar o assembly. Os manifestos contêm informações sobre o nome, a versão e o local do assembly, para que o aplicativo possa localizar, vincular e executar o assembly correto. Para obter mais informações, consulte Manifestos de aplicativo e implantação em soluções do Office.

Projetos em nível de documento incluem um documento além de um assembly. O documento atua como o front-end do aplicativo e é onde ocorre toda a interação do usuário. Cada documento pode ter apenas um assembly de projeto principal associado a ele; no entanto, vários documentos podem apontar para o mesmo assembly.

Assemblies em projetos de nível de documento não são incorporados no documento; em vez disso, eles são armazenados em outro lugar e são identificados pelo manifesto do aplicativo do documento.

Considerações de segurança para montagens

Para que uma solução do Office seja executada em um computador, os assemblies usados pela solução devem ser confiáveis para execução. Para obter mais informações sobre segurança, consulte Soluções do Office Seguro.

Por padrão, o assembly de solução e quaisquer assemblies referenciados que estão na pasta de saída do projeto são confiáveis para execução no computador de desenvolvimento quando você compila o projeto. Para obter mais informações, consulte Criar soluções do Office.

Por motivos de segurança, é melhor criar projetos no computador local, em vez de desenvolver em um local compartilhado. Para obter mais informações, consulte Desenvolvimento colaborativo de soluções do Office.

Assemblies referenciados

O assembly pode fazer referência a outros assemblies, que estão listados nas referências do projeto. No entanto, um assembly de projeto em nível de documento não pode fazer referência a outro assembly de projeto em nível de documento.

Conteúdo relacionado