Compartilhar via

Visão geral dos modelos de projeto do Office

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 no nível do documento

  • Suplementos do VSTO

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

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

    Cada projeto fornece arquivos e código para que você comece a usar um tipo específico de solução. 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 limpar sua solução 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 sã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 do documento

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

  • Documento VSTO do Word 2013 e 2016

  • Modelo VSTO do Word 2013 e 2016

  • Pasta de trabalho do 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 do VSTO do Excel 2010

  • Modelo VSTO do Excel 2010

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

    Os modelos de projeto do Modelo do Word e do Modelo do Excel se comportam de forma idêntica aos modelos de projeto do Documento do Word e da Pasta de Trabalho do Excel. No entanto, os modelos de projeto do Modelo do Word e do Modelo do Excel facilitam a criação de novos documentos locais ou cópias de 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 com base no 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 será chamado se o modelo for carregado 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 a usar esses tipos de projeto, consulte os seguintes tópicos:

Suplementos do VSTO

O nó do Office/SharePoint na caixa de diálogo Novo Projeto fornece os seguintes modelos de projeto para que você comece a criar Suplementos VSTO.

Soluções de documento versus modelo

Ao criar uma solução em torno de um documento do Word ou pasta de trabalho do Excel, você deve decidir a melhor maneira de disponibilizar esse documento para 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 Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

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

Em outras situações, talvez você queira disponibilizar um modelo em um servidor, para 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 do Word.

Comparison

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 esteja definido como 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 aciona o Open evento. Quando aberto, o modelo aciona o New evento.

Limitações de modelos globais e complementos 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 gerenciadas, o assembly do projeto não será chamado se o modelo estiver 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 ela 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 Microsoft Office Excel Add-In (*.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 não há suporte para esse uso da solução do Office.

Conteúdo relacionado

  • Last updated on