Trabalhar com Planilhas de Múltiplas Guias

Introdução

Se você precisa salvar cada guia do Excel como um arquivo independente, o GroupDocs.Editor para .NET torna isso simples. Seja extraindo relatórios financeiros, gerando planilhas por departamento ou convertendo guias para PDF, este tutorial orienta você por todo o fluxo de trabalho — desde a configuração do ambiente até a liberação de recursos — para que possa automatizar o manuseio de múltiplas planilhas com confiança.

Respostas Rápidas

  • O GroupDocs.Editor pode dividir um XLSX em arquivos separados? Sim, você pode carregar a pasta de trabalho e exportar cada planilha individualmente.
  • Em quais formatos cada guia pode ser salva? XLSX, CSV, PDF, HTML e mais – mais de 30 formatos de saída são suportados.
  • Preciso de uma licença para este recurso? Uma licença temporária funciona para testes; uma licença completa é necessária para produção.
  • O .NET Core é suportado? Absolutamente – a biblioteca funciona com .NET Framework 4.0+ e .NET Core/5/6+.
  • Quantas guias podem ser processadas de uma vez? O GroupDocs.Editor pode lidar com pastas de trabalho com mais de 500 planilhas sem carregar o arquivo inteiro na memória.

O que é “salvar cada guia do Excel”?

“Salvar cada guia do Excel” significa extrair cada planilha de uma pasta de trabalho com múltiplas guias e gravar cada uma em seu próprio documento independente (por exemplo, arquivos XLSX ou PDF separados). Essa abordagem simplifica o processamento posterior, a geração de relatórios e a distribuição ao fornecer um arquivo por planilha, que pode então ser compartilhado, arquivado ou transformado independentemente.

Por que usar o GroupDocs.Editor para esta tarefa?

O GroupDocs.Editor suporta mais de 30 formatos de entrada e saída e pode processar planilhas com até 1.000 guias mantendo o uso de memória baixo ao transmitir os dados em vez de carregar o arquivo inteiro. A API também preserva estilos de célula, fórmulas e imagens incorporadas, garantindo que cada guia exportada tenha a mesma aparência do original.

Pré-requisitos

Antes de mergulhar, verifique se você tem:

  1. Visual Studio – qualquer edição recente (Community, Professional ou Enterprise).
  2. .NET Framework 4.0+ – ou .NET Core/5/6 se você preferir o runtime multiplataforma.
  3. GroupDocs.Editor for .NET – faça o download na página de download.
  4. Licença – uma licença temporária serve para testes; adquira uma licença completa para uso em produção.
  5. Teste gratuito – você também pode experimentar a biblioteca através da página de teste gratuito.
  6. Suporte – se encontrar problemas, visite o fórum de suporte ou considere a página de compra para obter uma licença completa.

Importar Namespaces

Antes de começarmos a programar, você precisa importar os namespaces necessários. Adicione as seguintes diretivas using ao início do seu arquivo .cs:

using System.IO;
using GroupDocs.Editor.Formats;
using GroupDocs.Editor.Options;

Como salvar cada guia do Excel como um arquivo separado?

Carregue a pasta de trabalho, crie um EditableDocument para cada planilha e chame Save com o formato desejado. Esse processo isola cada guia, permite que você escolha um caminho de saída distinto e libera recursos automaticamente. Abaixo está o fluxo de trabalho passo a passo que você seguirá, com explicações para cada chamada de API e dicas de boas práticas para evitar armadilhas comuns.

Etapa 1: Obter um caminho para o arquivo de entrada

Primeiro, especifique o caminho completo para o XLSX de origem que contém várias guias.

string inputFilePath = "Your Sample Document";

Etapa 2: Carregar a planilha na instância do Editor

A classe Editor é o ponto de entrada para todas as operações de documento no GroupDocs.Editor. Ela lê o fluxo de arquivo e prepara o documento para edição ou extração.

using (FileStream inputStream = File.OpenRead(inputFilePath))
{
    using (Editor editor = new Editor(delegate { return inputStream; }, delegate { return new SpreadsheetLoadOptions(); }))
    {
        // Further steps will go here
    }
}

Etapa 3: Criar um EditableDocument a partir da primeira guia

EditableDocument representa uma única planilha editável dentro da pasta de trabalho. O construtor recebe a instância Editor e um índice de planilha baseado em zero.

SpreadsheetEditOptions editOptions1 = new SpreadsheetEditOptions();
editOptions1.WorksheetIndex = 0; // First tab
EditableDocument firstTabBeforeEdit = editor.Edit(editOptions1);

Etapa 4: Criar um EditableDocument a partir da segunda guia

Você pode repetir o mesmo padrão para qualquer planilha adicional alterando o valor do índice.

SpreadsheetEditOptions editOptions2 = new SpreadsheetEditOptions();
editOptions2.WorksheetIndex = 1; // Second tab
EditableDocument secondTabBeforeEdit = editor.Edit(editOptions2);

Etapa 5: Salvar a primeira guia em um documento separado

Save grava o documento editado em um arquivo no formato especificado. Chame‑o na instância EditableDocument, fornecendo o caminho de saída e o formato (por exemplo, SaveFormat.Xlsx).

SpreadsheetSaveOptions saveOptions1 = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsm);
string outputFilename1 = Path.GetFileNameWithoutExtension(inputFilePath) + "_tab1.xlsm";
string outputPath1 = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), outputFilename1);
editor.Save(firstTabBeforeEdit, outputPath1, saveOptions1);

Etapa 6: Salvar a segunda guia em um documento separado

A mesma chamada Save funciona para a segunda planilha, e você pode escolher um formato diferente, como PDF, se necessário.

SpreadsheetSaveOptions saveOptions2 = new SpreadsheetSaveOptions(SpreadsheetFormats.Xlsb);
string outputFilename2 = Path.GetFileNameWithoutExtension(inputFilePath) + "_tab2.xlsb";
string outputPath2 = Path.Combine(Constants.GetOutputDirectoryPath(inputFilePath), outputFilename2);
editor.Save(secondTabBeforeEdit, outputPath2, saveOptions2);

Etapa 7: Dispor das instâncias de EditableDocument

Dispose libera recursos não gerenciados mantidos pelo documento, como manipuladores de arquivos, garantindo que não haja vazamentos em serviços de longa duração.

firstTabBeforeEdit.Dispose();
secondTabBeforeEdit.Dispose();

Problemas Comuns e Soluções

  • Erros “File is locked” – Certifique‑se de chamar Dispose() em cada EditableDocument e na instância Editor, ou envolva‑os em declarações using.
  • Estilos ausentes após a exportação – Verifique se está salvando em um formato que suporte estilos (por exemplo, XLSX ou PDF). CSV perderá a formatação por design.
  • Pastas de trabalho grandes causam desempenho lento – Use as opções de carregamento em streaming (LoadOptions.Streaming = true) para manter o uso de memória baixo.

Perguntas Frequentes

Q: E se minha pasta de trabalho contiver planilhas ocultas?
A: Planilhas ocultas são tratadas como qualquer outra planilha; você pode acessá‑las por índice e salvá‑las, mas pode ser necessário definir EditableDocument.IsVisible = true antes de salvar se quiser que elas fiquem visíveis na saída.

Q: Posso converter uma guia do Excel diretamente para PDF?
A: Sim, especifique SaveFormat.Pdf ao chamar Save no EditableDocument. A biblioteca preserva o layout, imagens e gráficos durante a conversão.

Q: É possível dividir uma pasta de trabalho em arquivos CSV em vez de XLSX?
A: Absolutamente. Use SaveFormat.Csv para cada EditableDocument gerar representações CSV em texto simples de cada planilha.

Q: O GroupDocs.Editor suporta arquivos Excel protegidos por senha?
A: Sim. Forneça a senha via LoadOptions.Password ao criar a instância Editor.

Q: Onde posso encontrar mais exemplos de trabalho com planilhas?
A: A documentação oficial e os projetos de exemplo na página de download contêm casos de uso adicionais.

Conclusão

Seguindo estas etapas, você pode salvar cada guia do Excel como um documento independente, converter guias para PDF ou dividir grandes pastas de trabalho em partes manejáveis — tudo com a confiável e de alto desempenho biblioteca GroupDocs.Editor para .NET. Essa capacidade simplifica pipelines de relatórios, automatiza a extração de dados e reduz o manuseio manual de planilhas.

Última atualização: 2026-06-06
Testado com: GroupDocs.Editor 23.11 for .NET
Autor: GroupDocs

Tutoriais Relacionados