Item de Host da pasta de trabalho

Artigo
08/08/2011

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

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Excel 2007 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Em projetos de nível de documento, é um padrão Workbook item de host, que representa a pasta de trabalho no projeto. Em projetos de nível de aplicativo, você pode gerar Workbook itens do host em tempo de execução.

Noções básicas sobre 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 o ThisWorkbook classe. O ThisWorkbook classe fornece acesso a membros da Workbook o item de host para executar tarefas básicas de personalização, como a execução de código quando a pasta de trabalho é aberta ou fechada. For more information, see Programação personalizações em nível de documento.

O ThisWorkbook classe fornece um local no qual você pode começar a escrever código em seu projeto. Porque a classe fornece todas as mesmas propriedades, métodos e eventos como a Microsoft.Office.Interop.Excel.Workbook de objeto no assembly de interoperabilidade primária para o Excel, você também pode usar ThisWorkbook para acessar o modelo de objeto do Excel. For more information, see Visão geral do modelo de objeto do Excel.

Clique duas vezes o ThisWorkbook item de projeto em Solution Explorer para exibir o designer da pasta de trabalho e exibir as propriedades e eventos da pasta de trabalho na Propriedades janela.

Limitações do Item de Host de pasta de trabalho em projetos de nível de documento

Um projeto de nível de documento pode conter apenas um Workbook o item de host (isto é, o ThisWorkbook classe). Você não pode adicionar novas Workbook itens do host ao seu projeto no tempo de design e você não podem criar novos Workbook itens do host em tempo de execução de uma personalização no nível do documento.

Se você criar uma nova pasta de trabalho do Excel em tempo de execução, ele será do tipo Microsoft.Office.Interop.Excel.Workbook. Porque ele não é um item de host, ele não pode conter quaisquer controles de host ou controles 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.

O Workbook o item de host não atua como um recipiente para controles de host. Portanto, você não pode adicionar quaisquer controles visíveis na pasta de trabalho, mas você pode adicionar componentes, como um DataSet, de modo que os componentes podem 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 encontradas no componente guia, dados guia, e All Windows Forms guia da caixa de ferramentas.

Observação
As ferramentas de desenvolvimento do Office em Visual Studio não oferecem suporte a pastas compartilhadas.

Noções básicas sobre os itens de Host da pasta de trabalho em projetos de nível de aplicativo

Em projetos de nível de aplicativo, você pode gerar um Workbook o item de host em tempo de execução para qualquer pasta de trabalho que está aberto no Excel. Para gerar um Workbook item de host, use o GetVstoObject método. For more information, see Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.