Item de Host de planilha

Artigo
08/08/2011

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

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

Noções básicas sobre os itens de Host de planilha em projetos de nível de documento

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

Essas classes de planilha fornecem acesso a membros do Worksheet o item de host para executar tarefas básicas de personalização, como modificar o conteúdo de uma planilha. Você também pode usar essas classes para adicionar controles e as marcas inteligentes para planilhas. Combinando a diferentes conjuntos de controles e escrevendo o código, que você pode vincular controles a dados, coletar informações do usuário e responder a ações do usuário. For more information, see Programação personalizações em nível de documento.

Observação
As marcas inteligentes estão obsoletas no Excel 2010 e Word 2010. For more information, see Visão geral sobre marcas inteligentes.

As classes de planilha fornecem 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.Worksheet de objeto no assembly de interoperabilidade primária para o Excel, você também pode usar essas classes para acessar o modelo de objeto do Excel. For more information, see Visão geral do modelo de objeto do Excel.

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

A renomeação de planilhas

Em um projeto de nível de documento, você pode renomear as planilhas no designer de Visual Studio, mas este só muda o nome de exibição da planilha. O nome programático ainda é o nome padrão da planilha. Se você renomear a planilha no Propriedades janela, apenas o nome programático é alterada.

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

Não é possível criar novos Worksheet itens do 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, ele será do tipo Microsoft.Office.Interop.Excel.Worksheet. 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 a criação de documentos em tempo de execução, consulte Como: Adicionar novas planilhas para pastas de trabalho.

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

Em projetos de nível de aplicativo, você pode gerar um Worksheet o item de host em tempo de execução para qualquer planilha, que é aberto no Excel. Você pode usar o Worksheet o item de host para adicionar controles e as marcas inteligentes a planilha associados, ou para manipular eventos que não estão disponíveis em Microsoft.Office.Interop.Excel.Worksheet objetos.

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