Visão geral dos modelos de projeto do Office

  • Artigo

As ferramentas de desenvolvedor do Microsoft Office no Visual Studio incluem modelos de projeto para criar os seguintes tipos de soluções do Office:

  • Personalizações em nível de documento

  • Suplementos VSTO

    Para obter uma comparação detalhada desses tipos de soluções do Office, consulte Visão geral do desenvolvimento de soluções do Office (VSTO).

    Os modelos de projeto do Office estão disponíveis na caixa de diálogo Novo Projeto , no nó Office dos nós de linguagem Visual C# e Visual Basic . Cada modelo gera um projeto com configuração adequada para o aplicativo de destino, incluindo referências de assembly e configurações de depuração.

    Cada projeto fornece arquivos e código para que você comece em um tipo de solução específico. O código gerado para cada projeto inclui manipuladores de eventos de inicialização e desligamento. Você pode adicionar código a esses manipuladores de eventos para inicializar sua solução quando ela for carregada e limpá-la quando ela for descarregada. Para obter mais informações, consulte Projetos do Office no ambiente do Visual Studio e Eventos em projetos do Office.

Observação

As ferramentas de desenvolvimento do Office estão incluídas em determinadas edições do Visual Studio. Para obter mais informações, consulte Configurar um computador para desenvolver soluções do Office.

Personalizações no nível de documento

O nó do Office na caixa de diálogo Novo Projeto fornece os seguintes modelos de projeto para você começar a criar personalizações em nível de documento para Word e Excel:

  • Documento VSTO do Word 2013 e 2016

  • Modelo VSTO do Word 2013 e 2016

  • Pasta de trabalho VSTO do Excel 2013 e 2016

  • Modelo VSTO do Excel 2013 e 2016

  • Documento VSTO do Word 2010

  • Modelo VSTO do Word 2010

  • Pasta de trabalho VSTO do Excel 2010

  • Modelo VSTO do Excel 2010

    Os modelos de projeto da Pasta de Trabalho do Excel e do Documento do Word fornecem código para que você comece a criar uma solução que se baseie em uma pasta de trabalho ou em um documento específico. Nesses tipos de solução, seu código é executado apenas quando o documento associado é aberto no Word ou Excel.

    Os modelos de projeto do Modelo do Excel e Modelo do Word se comportam de forma idêntica aos modelos de projeto da Pasta de Trabalho do Excel e do Documento do Word. No entanto, os modelos de projeto do Modelo do Word e Modelo do Excel tornam mais fácil para os usuários criar novas cópias locais de documento ou pasta de trabalho do modelo personalizado em sua solução. Os recursos em sua solução estão disponíveis no novo documento que o usuário cria do modelo.

Observação

Os modelos do Word que fazem referência a extensões de código gerenciado não podem ser usados como suplementos VSTO globais. O assembly não é chamado se o modelo é carregado a partir do diretório de inicialização do Word. Para obter mais informações, consulte Limitações de modelos globais e suplementos do Excel (arquivos .xla).

Para obter informações sobre como começar esses tipos de projeto, consulte os seguintes tópicos:

Suplementos VSTO

O nó Office/SharePoint na caixa de diálogo Novo Projeto fornece os seguintes modelos de projeto para você começar a criar suplementos VSTO.

Soluções de documento versus modelo

Quando você cria uma solução em torno de uma pasta de trabalho do Excel e de um documento do Word, é preciso decidir a melhor maneira de disponibilizar esse documento a seus usuários.

Aplica-se a: As informações neste tópico se aplicam a projetos de nível de documento para Excel e Word. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Em algumas situações, talvez seja conveniente fornecer uma cópia de um documento para cada usuário. Nesse caso, crie sua solução usando um projeto de documento do Excel ou Word.

Em outras situações, talvez seja conveniente tornar um modelo disponível em um servidor, de modo que cada usuário possa abrir o modelo e salvar uma cópia local como um documento. Nesse caso, crie sua solução usando um projeto de modelo do Excel ou Word.

Comparação

A tabela a seguir descreve as diferenças entre documentos e modelos.

Documentos Modelos
Os usuários podem abrir e modificar um documento, a menos que ele seja definido para ser somente leitura. Todas as alterações salvas são mantidas no original. Os usuários podem abrir um modelo para criar uma cópia local como um novo documento. Eles não podem modificar o original, a menos que recebam permissões especiais.
Quando aberto, o documento gera o evento Open. Quando aberto, o modelo gera o evento New.

Limitações de modelos globais e suplementos do Excel (arquivos .xla)

Documentos, pastas de trabalho e modelos podem não funcionar corretamente como modelos globais ou suplementos VSTO do Excel (arquivos .xla).

Modelos do Word

Se um modelo do Microsoft Office Word tiver extensões de código gerenciado, o assembly do projeto não será chamado se o modelo for anexado como um modelo global ou carregado do diretório de inicialização do Word. Além disso, o documento não reconhece o formato de um modelo que faz parte de uma solução do Office.

Suplementos do Excel (arquivos .xla)

Não há nenhum projeto do Office para criar um suplemento VSTO do Excel (arquivo .xla ). É possível salvar uma pasta de trabalho como um arquivo .xla, mas não é uma operação com suporte e não é recomendada. Se você salvar uma pasta de trabalho que tenha extensões de código gerenciadas como um arquivo de suplemento do Microsoft Office Excel (*.xla), poderá selecioná-la na caixa de diálogo Suplementos para aplicar a outra pasta de trabalho. Em alguns casos, seu código será executado na pasta de trabalho de destino depois que o suplemento VSTO for aplicado, mas esse uso da solução do Office não é suportado.

Conteúdo relacionado