Item de Host da pasta de trabalho

Artigo
02/25/2013

O item host de Workbook é um tipo que estende o tipo de Microsoft.Office.Interop.Excel.Workbook do assembly de interoperabilidade primária para o excel.O item host de Workbook fornece todas as mesmas propriedades, métodos, eventos e que um objeto de Microsoft.Office.Interop.Excel.Workbook , mas 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 2013 e Excel 2010. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

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

Entendendo o item host de pasta de trabalho em projetos de um documento Nível

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

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

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

Limitações de item host de pasta de trabalho em projetos de um documento Nível

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

Se você criar uma nova pasta de trabalho do Excel em tempo de execução, será de tipo Microsoft.Office.Interop.Excel.Workbook.Porque não é um item host, não pode conter os controles host ou controles de formulários do windows.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 item host de Workbook não atua como um recipiente para controles host.Portanto, você não pode adicionar os controles visíveis para a pasta de trabalho, mas você pode adicionar componentes, como DataSet, para que os componentes podem ser compartilhados por todas as planilhas.Em um projeto de um documento nível, os componentes disponíveis para a pasta de trabalho podem ser encontrados na guia de Componente , na guia de Dados , e na guia de Todos os Windows Forms de Caixa de Ferramentas.

Observação
Ferramentas de desenvolvimento do Office no Visual Studio não suportam pastas de trabalho compartilhadas.

Itens entendendo de host pasta de trabalho em projetos de Nível de aplicativo

Em projetos de aplicativo, você pode gerar um item de host de Workbook em tempo de execução para qualquer pasta de trabalho do excel que é aberto.Para gerar um item de host de Workbook , use o método de GetVstoObject .Para obter mais informações, consulte Estendendo os documentos do Word e pastas de trabalho do Excel em suplementos de nível de aplicativo em tempo de execução.