Item hospedeiro da planilha

O Workbook item do host é um tipo que estende o tipo do Workbook do assembly de interoperabilidade primário para o Excel. O Workbook item de host fornece todas as mesmas propriedades, métodos e eventos como 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 Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

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 complemento VSTO, você pode gerar Workbook itens de host em tempo de execução.

Entender o item de host do livro de trabalho em projetos de nível de documento

Para acessar a pasta de trabalho em seu projeto, use a classe ThisWorkbook. A ThisWorkbook classe fornece acesso aos membros do Workbook item host para executar tarefas básicas na sua personalização, como executar código quando a pasta de trabalho é aberta ou fechada. Para obter mais informações, consulte Personalizações no nível do 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 Workbook objeto no assembly de interoperabilidade primário do Excel, você também pode usar ThisWorkbook para acessar o modelo de objeto do Excel. Para obter mais informações, consulte a 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 hospedeiro da pasta de trabalho em projetos no nível do documento

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

Se você criar uma nova pasta de trabalho do Excel em tempo de execução, ela será do tipo Workbook. Como 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 novas pastas de trabalho programaticamente.

O Workbook item de host não funciona como um contêiner para controles de host. Portanto, você não pode adicionar controles visíveis à pasta de trabalho, mas pode adicionar componentes, como um DataSet, para que os componentes possam ser compartilhados por todas as planilhas. Em um projeto no nível do 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.

Entender os itens de host da pasta de trabalho em projetos de suplemento do VSTO

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

Conteúdo relacionado

• Exemplos de desenvolvimento do Office e instruções passo a passo
• Estender documentos do Word e pastas de trabalho do Excel em Add-ins VSTO em tempo de execução
• Visão geral de itens de host e controles de host
• Item de host de planilha
• Automatizar o Excel usando objetos estendidos
• Limitações programáticas de itens de host e controles de host