Carregar planilhas visíveis somente do arquivo Excel

Introdução

Ao trabalhar com arquivos do Excel em seus aplicativos .NET, o desafio de gerenciar várias planilhas se torna aparente, especialmente quando algumas estão ocultas ou não são relevantes para sua operação. Aspose.Cells para .NET é uma biblioteca poderosa que ajuda você a manipular arquivos do Excel de forma eficiente. Neste artigo, exploraremos como carregar apenas as planilhas visíveis de um arquivo do Excel, filtrando quaisquer dados ocultos. Se você já se sentiu sobrecarregado ao navegar pelos seus dados do Excel, este guia é para você!

Pré-requisitos

Antes de mergulhar no tutorial, vamos garantir que você tenha tudo o que precisa para seguir adiante:

  1. Noções básicas de C#: Este tutorial foi criado para desenvolvedores familiarizados com a linguagem de programação C#.
  2. Aspose.Cells para .NET: Você deve ter a biblioteca Aspose.Cells para .NET baixada e configurada. Você podebaixe a biblioteca aqui.
  3. Visual Studio ou qualquer IDE: você deve ter um IDE onde possa escrever e testar seu código C#.
  4. .NET Framework: certifique-se de ter o .NET Framework necessário instalado para executar seus aplicativos.
  5. Um arquivo de exemplo do Excel: para praticar, crie um arquivo de exemplo do Excel ou siga o código fornecido. Tem tudo pronto? Incrível! Vamos lá!

Pacotes de importação

Um dos primeiros passos em qualquer projeto C# trabalhando com Aspose.Cells é importar os pacotes necessários. Isso permite que você acesse todas as funcionalidades fornecidas pela biblioteca. Veja como fazer isso:

  1. Abra seu projeto: comece abrindo seu projeto C# no Visual Studio ou qualquer outro IDE de sua preferência.
  2. Adicionar referências: clique com o botão direito do mouse no seu projeto no Solution Explorer, selecione “Adicionar” e depois “Referência”.
  3. Procure por Aspose.Cells: localize o arquivo Aspose.Cells.dll que você baixou anteriormente e adicione-o às referências do seu projeto. Esta etapa é crucial, pois vincula a funcionalidade do Aspose.Cells ao seu projeto.
using System.IO;
using Aspose.Cells;
using System;

Agora que você importou os pacotes necessários, criaremos uma pasta de trabalho do Excel de exemplo. Nessa pasta de trabalho, teremos várias planilhas, e uma delas ficará oculta para este tutorial.

Etapa 1: configure seu ambiente

Primeiro, vamos configurar o ambiente e especificar os caminhos para o arquivo de amostra.

// O caminho para o diretório de documentos.
string dataDir = "Your Document Directory";
string sampleFile = "output.xlsx";
string samplePath = dataDir + sampleFile;

Neste trecho de código, substitua"Your Document Directory" com o caminho real onde você deseja salvar sua pasta de trabalho.

Etapa 2: Crie a pasta de trabalho

Em seguida, vamos criar a pasta de trabalho e adicionar alguns dados.

// Crie uma pasta de trabalho de exemplo
Workbook createWorkbook = new Workbook();
createWorkbook.Worksheets["Sheet1"].Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets.Add("Sheet2").Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets.Add("Sheet3").Cells["A1"].Value = "Aspose";
createWorkbook.Worksheets["Sheet3"].IsVisible = false; // Tornar a Planilha3 oculta
createWorkbook.Save(samplePath);

Aqui está um resumo do que está acontecendo:

  • Estamos criando uma nova pasta de trabalho e adicionando três planilhas.
  • “Sheet1” e “Sheet2” ficarão visíveis, enquanto “Sheet3” ficará oculta.
  • Em seguida, salvamos a pasta de trabalho no caminho especificado.

Etapa 3: Carregue a pasta de trabalho de exemplo com opções de carregamento

Agora que temos uma pasta de trabalho com planilhas visíveis e ocultas, é hora de carregá-la, garantindo que acessaremos apenas as planilhas visíveis.

LoadOptions loadOptions = new LoadOptions();
loadOptions.LoadFilter = new CustomLoad();

Este trecho de código configura as opções de carregamento para a pasta de trabalho, que personalizaremos para filtrar planilhas ocultas.

Etapa 4: Defina o filtro de carga personalizado

Para carregar somente folhas visíveis, precisamos criar um filtro de carregamento personalizado. Veja como defini-lo:

class CustomLoad : LoadFilter
{
    public override void StartSheet(Worksheet sheet)
    {
        if (sheet.IsVisible)
        {
            this.LoadDataFilterOptions = LoadDataFilterOptions.All;
        }
        else
        {
            this.LoadDataFilterOptions = LoadDataFilterOptions.Structure;
        }
    }
}
  • OStartSheet O método verifica se cada folha está visível.
  • Se estiver visível, ele carrega todos os dados daquela planilha.
  • Se não estiver visível, ele ignora o carregamento de quaisquer dados daquela planilha.

Etapa 5: Carregue a pasta de trabalho usando as opções de carregamento

Agora vamos carregar a pasta de trabalho e exibir os dados das planilhas visíveis.

Workbook loadWorkbook = new Workbook(samplePath, loadOptions);
Console.WriteLine("Sheet1: A1: {0}", loadWorkbook.Worksheets["Sheet1"].Cells["A1"].Value);
Console.WriteLine("Sheet2: A1: {0}", loadWorkbook.Worksheets["Sheet2"].Cells["A1"].Value);

Este trecho de código utiliza oloadOptions para importar apenas dados das planilhas visíveis e exibir o conteúdo da célula A1 de “Planilha1” e “Planilha2”.

Conclusão

aí está! Você aprendeu com sucesso como carregar apenas planilhas visíveis de um arquivo Excel usando Aspose.Cells para .NET. Gerenciar suas planilhas do Excel pode ser moleza quando você sabe como limitar os dados que recupera e trabalha apenas com o que precisa. Isso não apenas melhora a eficiência de seus aplicativos, mas também torna seu código mais limpo e fácil de gerenciar.

Perguntas frequentes

Posso carregar folhas ocultas se necessário?

Sim, você pode simplesmente ajustar as condições no filtro de carga personalizado para incluir planilhas ocultas.

Para que é usado o Aspose.Cells?

O Aspose.Cells é usado para manipular arquivos do Excel sem exigir a instalação do Microsoft Excel, oferecendo funcionalidades como leitura, gravação e gerenciamento de planilhas do Excel.

Existe uma versão de teste do Aspose.Cells?

Sim, você podebaixe uma versão de teste gratuita para testar suas funcionalidades.

Onde posso encontrar documentação para Aspose.Cells?

Odocumentação fornece informações abrangentes sobre todos os recursos.

Como faço para comprar o Aspose.Cells?

Você pode facilmentecomprar Aspose.Cells na página de compra.

Manter separadores para linhas em branco no Excel