Item de host de planilha

  • Artigo

O Worksheet item de host é um tipo que estende o Worksheet tipo do assembly de interoperabilidade primário para Excel. O Worksheet item de host fornece todas as mesmas propriedades, métodos e eventos como um objeto, mas também expõe eventos adicionais e atua como um Worksheet contêiner para controles de host e controles do Windows Forms.

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

Compreender itens de host de planilha em projetos de nível de documento

Quando você cria um projeto de nível de documento para o Excel, o Visual Studio cria automaticamente três Worksheet itens de host no projeto. Os nomes padrão das planilhas são Sheet1, Sheet2e Sheet3. Se você criar um projeto com base em uma pasta de trabalho existente, o número de itens de host dependerá do número de planilhas na pasta de trabalho.

Essas classes de planilha fornecem acesso a membros do item de host para executar tarefas básicas em sua personalização, como modificar o conteúdo de Worksheet 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 vincular os controles a dados, coletar informações do usuário e responder a ações do usuário. Para obter mais informações, consulte Personalizações em nível de documento do programa.

As classes de planilha fornecem 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 essas classes para acessar o Worksheet modelo de objeto do Excel. Para obter mais informações, consulte Visão geral do modelo de objeto do Excel.

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

Renomear planilhas

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

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

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

Compreender itens de host de planilha em projetos de suplemento VSTO

Em projetos de nível de aplicativo, você pode gerar um Worksheet item de host em tempo de execução para qualquer planilha aberta no Excel. Você pode usar o item de Worksheet host para adicionar controles à planilha associada ou para manipular eventos que não estão disponíveis em Worksheet objetos.

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

Conteúdo relacionado