Compartilhar via

Excluir planilhas programaticamente de pastas de trabalho

  • Artigo

Você pode excluir qualquer planilha em uma pasta de trabalho. Para excluir uma planilha, use o item de host da planilha ou acesse a planilha usando a coleção de planilhas da pasta de trabalho.

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.

Usar o item de host da planilha

Se a planilha foi adicionada em tempo de design em uma personalização em nível de documento, use o Delete método para excluir uma planilha especificada. O código a seguir exclui uma planilha de uma pasta de trabalho fazendo referência ao item de host da planilha diretamente.

Importante

Esse código é executado somente em projetos que você cria usando qualquer um dos seguintes modelos de projeto:

  • Pasta de trabalho do Excel 2013

  • Modelo do Excel 2013

  • Pasta de trabalho do Excel 2010

  • Modelo do Excel 2010

    Se você deseja executar essa tarefa em qualquer outro tipo de projeto, você deve adicionar uma referência ao assembly Microsoft.Office.Interop.Excel e, em seguida, você deve usar classes desse assembly para abrir uma pasta de trabalho e excluir uma planilha. Para obter mais informações, consulte Como direcionar aplicativos do Office por meio de assemblies de interoperabilidade primários e Referência de assembly de interoperabilidade primária do Excel 2010.

Para excluir uma planilha usando um item de host de planilha

  1. Chame o método Delete de Sheet1.

    Globals.Sheet1.Delete();

Usar a coleção Planilhas da pasta de trabalho do Excel

Acesse planilhas por meio da coleção do Microsoft Office Excel Sheets nos seguintes casos:

  • Você deseja excluir uma planilha em um suplemento VSTO.

  • A planilha que você deseja excluir foi criada em tempo de execução em uma personalização em nível de documento.

    O código a seguir exclui uma planilha de uma pasta de trabalho fazendo referência à planilha por meio do número de índice da coleção Sheets . Esse código pressupõe que uma nova planilha foi criada programaticamente.

Importante

Se você deseja executar essa tarefa em qualquer outro tipo de projeto, você deve adicionar uma referência ao assembly Microsoft.Office.Interop.Excel e, em seguida, você deve usar classes desse assembly para abrir uma pasta de trabalho e excluir uma planilha. Para obter mais informações, consulte Como direcionar aplicativos do Office por meio de assemblies de interoperabilidade primários e Referência de assembly de interoperabilidade primária do Excel 2010.

Para excluir uma planilha usando a coleção Planilhas da pasta de trabalho do Excel

  1. Chame Sheets o Delete método da coleção.

    ((Excel.Worksheet)this.Application.ActiveWorkbook.Sheets[4]).Delete();

Conteúdo relacionado