Projetando e criando soluções do Office

Artigo
02/25/2013

Visual Studio fornece os 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 a criação de projetos do Office.Para obter informações sobre como implementar personalizações de código e de interface do usuário depois que você criou o projeto, consulte Desenvolvendo soluções do Office.

Aplicáve a: As informações neste tópico se aplicam a projetos em nível de aplicativo e em nível de documento para o Office 2013 e o Office 2010. Consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Criando projetos do Office

Antes de iniciar, você deve determinar seus requisitos e descobrir o tipo de solução que oferece melhor ajuste.Por exemplo, se sua solução do Office deve executar as vezes o aplicativo é usado, um melhor do suplemento ao nível couber seus requisitos.Se o código está integrado com segurança com um único documento, crie uma personalização de um documento nível.Esses tipos de projeto estão disponíveis como modelos de projeto Visual Studio.Para obter mais informações sobre modelos de projeto do Office que são incluídos com o 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 em Visual Studio.

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

Escolhendo uma versão do.NET Framework

Após selecionado o tipo de projeto que melhor se adapta suas necessidades, você pode escolher qual versão do.NET Framework para 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

Observação
As soluções do Office podem focar .NET Framework 4.5 somente se você instalar as ferramentas do desenvolvedor do Microsoft Office para Visual Studio 2012.Para obter mais informações, consulte” Página de downloadno “ferramentas.

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 é executado.Por exemplo, se seu projeto utiliza .NET Framework 4, .NET Framework 4 é necessário em computadores de usuário final.Nesse exemplo, sua solução não será executado se apenas o.NET Framework 3.5 é instalado em computadores de usuário final.

Se você migre um projeto do suplemento ao nível que tem como alvo o .NET Framework 3.5, Visual Studio altera a estrutura de destino do seu projeto a .NET Framework 4.

Se você instalar o Microsoft Office Developer Tools for Visual Studio 2012, o Visual Studio altera a estrutura de destino do projeto para .NET Framework 4.5.

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

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

Observação
Você não pode direcionar o .NET Framework 3.5 ou anterior no Office projetos que você cria usando Visual Studio 2012.Office projetos que você cria usando Visual Studio 2012 requer os recursos que foram introduzidos em primeiro .NET Framework 4 Client Profile

Compreensão quando os PIAs do Office são necessários em computadores de usuário final

Por padrão, os assemblies de interoperabilidade primários (PIAs) do Office não precisam ser instalados em computadores de usuário final se a propriedade de Inserir Tipos Interop cada referência de PIA do Office no projeto é definida como True, que é o valor padrão.Nesse cenário, as informações de tipo para tipos de PIA que são usados por sua solução é inserida no assembly de solução quando você criar o projeto.Em tempo de execução, informações inserida de tipo é usada em vez de PIAs para chamar o modelo de objeto baseados em COM de aplicativo do Office.Para obter mais informações sobre como os tipos de PIAs são inseridos em sua solução, consulte Digite equivalência e tipos de interoperabilidade incorporados.

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

Entendendo o perfil de cliente

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

Quando você cria um projeto do Office que tem como alvo .NET Framework 4, .NET Framework 4 Client Profile é definido por padrão. Se você deseja se tornar para .NET Framework 4completo, você deve definir esta opção após o projeto é criado.Para obter mais informações, consulte Como: usar uma versão do.NET Framework.

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

Microsoft Office 2013 e Office 2010 estão disponíveis em edições de 64 bits e 32 bits.Para criar soluções do Office que podem executar em qualquer edição, a plataforma fixaçãoa de alvos para seu projeto deve ser definida como Qualquer CPU.Este é o valor padrão para projetos do Office. Para obter mais informações, consulte Construindo soluções do Office.

Existem versões de 64 bits e 32 bits separadas de Visual Studio Tools for Office Runtime que são usadas por edições de 64 bits e 32 bits do Microsoft Office 2013 e de Office 2010.Para obter mais informações, consulte Visual Studio Tools for Office visão geral sobre o tempo de execução.

Assemblies em soluções do Office

Quando você criar 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 é geralmente implantado em um servidor compartilhado ou um diretório no computador cliente.

Os assemblies em 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 conjunto também pode chamar no modelo de objeto para automatizar e estender o aplicativo, e pode usar algumas das classes em .NET Framework. Para obter mais informações, consulte Arquitetura de personalizações em nível de documento e Arquitetura dos suplementos de nível de aplicativo.

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, versão, e o local do assembly, para que o aplicativo possa localizar, vincular a, e executar o assembly correto.Para obter mais informações, consulte Manifestos de aplicativo e implantação em soluções do Office.

Os projetos de um documento nível incluem um documento além de um assembly.O documento atua como a parte final frontal aplicativo e é onde qualquer interação do usuário ocorre.Cada documento pode ter apenas um conjunto principal do projeto associado a ele; no entanto, vários documentos podem apontar para o mesmo assembly.

Os assemblies em projetos de um documento nível não são inseridos no documento; em vez disso, são armazenados em outro lugar e identificados pelo manifesto do aplicativo do documento.

Considerações de segurança para os assemblies

Para uma solução do Office a execução em um computador, assemblys usados pela solução devem ser confiáveis para executar.Para obter mais informações sobre segurança, consulte Protegendo soluções do Office.

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

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

Assemblies referenciados

O assembly pode referenciar outros assemblies, que são listados em referências do projeto.Entretanto, um assembly de projeto de um documento nível não pode referenciar outro assembly de projeto de um documento nível.

Consulte também

Compartilhar via