Item de Host de planilha

Artigo
02/25/2013

O item host de Worksheet é um tipo que estende o tipo de Microsoft.Office.Interop.Excel.Worksheet do assembly de interoperabilidade primária para o excel.O item host de Worksheet fornece todas as mesmas propriedades, métodos, eventos e que um objeto de Microsoft.Office.Interop.Excel.Worksheet , mas também expõe eventos adicionais e atua como um recipiente para controles host e controles dos formulários do windows.

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, você pode adicionar itens host de Worksheet ao seu projeto em tempo de design.Em projetos de aplicativo, você pode gerar itens de host de Worksheet em tempo de execução.

Itens entendendo host da planilha em projetos de um documento Nível

Quando você cria um projeto da nível do excel, o Visual Studio automaticamente cria três itens de host de Worksheet no projeto.Os nomes padrão de planilhas são Sheet1, Sheet2, e Sheet3.Se você criar um projeto com base em uma pasta de trabalho existente, o número de itens host depende do número de planilhas na pasta de trabalho.

Essas classes a planilha oferecem acesso a membros de item host de Worksheet para executar tarefas básicas da sua personalização, como a alteração do conteúdo de uma planilha.Você também pode usar essas classes para adicionar controles a planilhas.Combinando diferentes conjuntos de controles e escrevendo código, você pode associar controles a dados, colete informações do usuário, e responder às ações do usuário.Para obter mais informações, consulte Programação personalizações em nível de documento.

As classes de planilha fornecem 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.Worksheet no assembly de interoperabilidade primária para o excel, você também pode usar essas classes para acessar o modelo de objeto do excel.Para obter mais informações, consulte Visão geral sobre o modelo de objeto do Excel.

Em projetos de um documento nível, você pode adicionar itens adicionais de host de Worksheet ao projeto em tempo de design adicionando uma nova planilha para a pasta de trabalho no designer.

renomeando planilhas

Em um projeto da nível de usuário, você pode renomear as planilhas no designer do Visual Studio, mas isso altera somente o nome para exibição da planilha.O nome através de programação ainda é o nome da planilha padrão.Se você renomear a planilha na janela de Propriedades , somente o nome através de programação é alterado.

Limitações de item host a planilha em projetos de um documento Nível

Você não pode criar novos itens de host de Worksheet em tempo de execução em um projeto de um documento nível.Se você criar uma nova planilha do excel em tempo de execução, será de tipo Microsoft.Office.Interop.Excel.Worksheet.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 documentos em tempo de execução, consulte Como adicionar novas planilhas a pastas de trabalho programaticamente.

Itens entendendo host da planilha em projetos de Nível de aplicativo

Em projetos de aplicativo, você pode gerar um item de host de Worksheet em tempo de execução para qualquer planilha do excel que é aberto.Você pode usar o item host de Worksheet para adicionar controles à planilha associado, ou para manipular eventos que não estão disponíveis em Microsoft.Office.Interop.Excel.Worksheet objetos.

Para gerar um item de host de Worksheet , 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.