Share via


Projetos do Office no ambiente do Visual Studio

Os projetos do Microsoft Office têm uma experiência de desenvolvimento semelhante a outros tipos de projeto no Visual Studio, como projetos do Windows Forms. Quando você cria ou abre um projeto do Office, os itens de projeto aparecem no Gerenciador de Soluções. Para projetos no nível de documento, o documento (isto é, o documento do Word ou a pasta de trabalho do Excel) é aberto no Visual Studio e se comporta como um designer visual.

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.

Itens de projeto no Gerenciador de Soluções

Em um projeto de nível de documento, o Gerenciador de Soluções exibe os seguintes itens padrão:

  • Nós do documento, da pasta de trabalho e das folhas que são personalizados pelo projeto. Esses nós servem como contêineres para os arquivos de código que são associados ao documento, à pasta de trabalho e às folhas.

  • Arquivos de código que são associados ao documento, à pasta de trabalho e às folhas que são personalizados pelo projeto. Em projetos do Word, os arquivos de código são associados ao documento ou modelo do Word. Em projetos do Excel, os arquivos de código são associados à pasta de trabalho ou ao modelo do Excel, e a cada planilha e planilha de gráfico na pasta de trabalho ou no modelo.

  • Arquivos de projeto que você não tem pretensão de editar diretamente. Para obter mais informações, consulte Arquivos de projeto ocultos.

    Em um projeto de suplemento VSTO, o Gerenciador de Soluções exibe os seguintes itens padrão:

  • O nó do aplicativo. Esse nó tem o mesmo nome que o aplicativo host, como Word, Excel ou Outlook. O nó do aplicativo contém o arquivo de código ThisAddIn. Ele também fornece o Namespace para a propriedade Host Item . Para obter mais informações sobre essa propriedade, consulte Propriedades em projetos do Office.

  • O arquivo de código ThisAddIn. Esse arquivo contém a classe gerada ThisAddIn para o suplemento VSTO. Para obter mais informações sobre essa classe, consulte Suplementos do VSTO do programa.

  • Arquivos de projeto que você não tem pretensão de editar diretamente. Para obter mais informações, consulte Arquivos de projeto ocultos.

Certificados temporários

Os projetos do Office também incluem um certificado temporário chamado Nome do Projeto_TemporaryKey.pfx. Esse certificado é usado para assinar o aplicativo e os manifestos de implantação do projeto durante o desenvolvimento. Para obter mais informações, consulte Conceder confiança às soluções do Office e às soluções do Office Seguro.

Arquivos de projeto ocultos

Vários arquivos de projeto são ocultados por padrão. Esses arquivos são gerados pelo Visual Studio e diferem por tipo de projeto. Para exibir os arquivos ocultos, clique em Mostrar Todos os Arquivos no Gerenciador de Soluções.

Não modifique os arquivos de projeto ocultos. A alteração direta desses arquivos não tem suporte e pode corromper seu projeto. Os arquivos de projeto ocultos são regenerados sempre que determinadas alterações ocorrerem no documento. Se você fizer alterações manuais em um arquivo de projeto oculto, essas alterações serão perdidas quando o arquivo for regenerado.

Designer de documentos em projetos de nível de documento

Os projetos no nível de documento do Excel e Word fornecem um designer que hospeda o documento que é associado ao seu projeto no Visual Studio. O designer permite modificar o documento sem precisar sair do ambiente do Visual Studio.

Para abrir um documento no designer, clique duas vezes no arquivo de código no Gerenciador de Soluções associado ao documento. Por exemplo, para abrir a planilha Sheet1 no designer em um projeto do Excel, clique duas vezes no arquivo de código Sheet1.

Ao modificar o documento no designer, você pode aproveitar a funcionalidade nativa do aplicativo do Office. Por exemplo, é possível digitar texto no documento ou em uma planilha, ou usar a Faixa de Opções para executar tarefas como adicionar uma tabela ou um gráfico. Por padrão, o mapeamento do atalho de teclado é padronizado para o mapeamento do Visual Studio. Para usar mapeamentos de atalho de teclado do Office, altere as configurações no nó Configurações do Teclado do Microsoft Office na caixa de diálogo Opções no menu Ferramentas .

Controles em documentos

Você pode arrastar controles de host e controles do Windows Forms da caixa de ferramentas do Visual Studio para a superfície de design do documento. Os controles de host são versões especializadas de objetos do Office, como controles de conteúdo do Word e intervalos do Excel, que podem ser usados em projetos do Office criados usando o Visual Studio. Os controles de host têm recursos adicionais que não estão disponíveis nos objetos do Office correspondentes, como associação de dados e eventos adicionais.

Para obter mais informações, consulte Visão geral de itens de host e controles de host e Visão geral de controles de formulários do Windows em documentos do Office.

Planilhas e pastas de trabalho do Excel no Designer

Ao abrir uma planilha no designer, você pode modificá-la da mesma forma que o faz quando ela é aberta diretamente no Excel. Se você clicar duas vezes na célula de uma planilha, a célula é alterada para o modo de edição. Se você clicar duas vezes em uma célula que contém um controle de host, o Editor de código abre e Visual Studio gera o manipulador de eventos padrão para o controle. Para navegar para outras planilhas, você pode clicar nas guias da planilha na parte inferior do designer.

Quando você abre a pasta de trabalho no designer, não há superfície de design. O modo de exibição de design da pasta de trabalho é uma grande bandeja de componente que preenche o designer.

A pasta de trabalho e cada folha dela têm um arquivo de código associado. Cada arquivo de código contém uma classe de item de host gerada que representa a pasta de trabalho ou planilha. Para obter mais informações, consulte Automatizar o Excel usando objetos estendidos.

Documentos do Word no designer

Ao abrir o documento no designer, você pode modificá-lo da mesma forma que o faz quando ele é aberto diretamente no Word. Se você clicar duas vezes em uma palavra no documento, essa palavra será selecionada. No entanto, se a palavra estiver dentro de um controle de host, o editor de códigos será aberto e o Visual Studio vai gerar o manipulador de eventos padrão para o controle.

O documento tem um arquivo de código associado. O arquivo de código contém uma classe de item de host gerada que representa o documento. Para obter mais informações, consulte Item de host do documento.

Modo de design versus modo de tempo de execução

Quando um documento é aberto no ambiente do Visual Studio, ele está sempre no modo de design. Algumas tarefas, como arrastar um controle de host para a superfície de documento, podem ser executadas somente no modo de design.

Para exibir o documento no modo de tempo de execução, você deve abrir o aplicativo e o documento fora do Visual Studio. Também é possível compilar e executar o projeto, que abrirá automaticamente o documento e o aplicativo fora do Visual Studio.

Editor de Códigos

O Editor de Códigos permite exibir e modificar os arquivos de código visíveis na sua solução. Esses arquivos contêm o código que define o comportamento da sua solução.

Para obter mais informações sobre o Editor de código, consulte Escrever código no editor de código e texto. Para obter mais informações sobre como escrever código em projetos do Office, consulte Escrever código em soluções do Office.

Janela de Propriedades

A janela Propriedades exibe propriedades para itens de projeto selecionados no Gerenciador de Soluções e para elementos da interface do usuário selecionados no designer, como controles ou o documento em um projeto de nível de documento. Algumas propriedades são específicas do aplicativo e do documento, enquanto outras são iguais em todos os projetos.

janela Fontes de Dados

Você pode usar a janela Fontes de Dados em projetos do Office em nível de documento para arrastar uma fonte de dados para o documento e criar um controle vinculado à fonte de dados. Para obter mais informações, confira Associar controles a dados no Visual Studio.