Compartilhar via


Item de host da pasta de trabalho

O Workbook item de host é um tipo que estende o Workbook tipo do assembly de interoperabilidade primário para Excel. O Workbook item de host fornece todas as mesmas propriedades, métodos e eventos que um Workbook objeto, mas também fornece recursos adicionais.

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

Em projetos de nível de documento, há um item de host padrão Workbook que representa a pasta de trabalho em seu projeto. Em projetos de suplemento VSTO, você pode gerar Workbook itens de host em tempo de execução.

Compreender o item de host da pasta de trabalho em projetos de nível de documento

Para acessar a pasta de trabalho em seu projeto, use a ThisWorkbook classe. A ThisWorkbook classe fornece acesso a membros do item de host para executar tarefas básicas em sua personalização, como executar código quando a pasta de Workbook trabalho é aberta ou fechada. Para obter mais informações, consulte Personalizações em nível de documento do programa.

A ThisWorkbook classe fornece um local no qual você pode começar a escrever código em seu projeto. Como a classe fornece todas as mesmas propriedades, métodos e eventos que o objeto no assembly de interoperabilidade primário para Excel, você também pode usar ThisWorkbook para acessar o Workbook modelo de objeto do Excel. Para obter mais informações, consulte Visão geral do modelo de objeto do Excel.

Clique duas vezes no item de projeto ThisWorkbook no Gerenciador de Soluções para exibir o designer de pasta de trabalho e exibir as propriedades e eventos da pasta de trabalho na janela Propriedades.

Limitações do item de host da pasta de trabalho em projetos de nível de documento

Um projeto em nível de documento pode conter apenas um Workbook item de host (ou seja, a ThisWorkbook classe). Não é possível adicionar novos itens de host ao projeto em tempo de design e não é possível criar novos Workbook Workbook itens de host em tempo de execução a partir de uma personalização em nível de documento.

Se você criar uma nova pasta de trabalho do Excel em tempo de execução, ela será do tipo Workbook. Como ele não é um item de host, ele não pode conter controles de host ou controles do Windows Forms. Para obter mais informações sobre como criar pastas de trabalho em tempo de execução, consulte Como: Criar programaticamente novas pastas de trabalho.

O Workbook item de host não atua como um contêiner para controles de host. Portanto, você não pode adicionar nenhum controle visível à pasta de trabalho, mas você pode adicionar componentes, como um DataSet, para que os componentes possam ser compartilhados por todas as planilhas. Em um projeto de nível de documento, os componentes disponíveis para a pasta de trabalho podem ser encontrados na guia Componente, na guia Dados e na guia Todos os Windows Forms da Caixa de Ferramentas.

Observação

As ferramentas de desenvolvimento do Office no Visual Studio não oferecem suporte a pastas de trabalho compartilhadas.

Compreender itens de host de pasta de trabalho em projetos de suplemento VSTO

Em projetos de suplemento VSTO, você pode gerar um item de Workbook host em tempo de execução para qualquer pasta de trabalho que esteja aberta no Excel. Para gerar um item de Workbook host, use o GetVstoObject método. Para obter mais informações, consulte Estender documentos do Word e pastas de trabalho do Excel em suplementos VSTO em tempo de execução.