Carica solo i fogli visibili dal file Excel

Introduzione

Quando lavori con file Excel nelle tue applicazioni .NET, la sfida di gestire più fogli di lavoro diventa evidente, specialmente quando alcuni sono nascosti o non pertinenti alla tua operazione. Aspose.Cells per .NET è una potente libreria che ti aiuta a manipolare i file Excel in modo efficiente. In questo articolo, esploreremo come caricare solo i fogli visibili da un file Excel, filtrando tutti i dati nascosti. Se ti sei mai sentito sopraffatto dalla navigazione dei tuoi dati Excel, questa guida è per te!

Prerequisiti

Prima di immergerci nel tutorial, assicuriamoci di avere tutto il necessario per seguirlo:

  1. Nozioni di base di C#: questo tutorial è pensato per gli sviluppatori che hanno familiarità con il linguaggio di programmazione C#.
  2. Aspose.Cells per .NET: devi avere la libreria Aspose.Cells per .NET scaricata e configurata. Puoiscarica la libreria qui.
  3. Visual Studio o qualsiasi IDE: dovresti avere un IDE in cui scrivere e testare il tuo codice C#.
  4. .NET Framework: assicurati di aver installato la versione .NET Framework necessaria per eseguire le tue applicazioni.
  5. Un file Excel di esempio: per esercitarti, crea un file Excel di esempio o segui il codice fornito. Tutto pronto? Fantastico! Cominciamo!

Importa pacchetti

Uno dei primi passaggi in qualsiasi progetto C# che lavora con Aspose.Cells è l’importazione dei pacchetti richiesti. Ciò consente di accedere a tutte le funzionalità fornite dalla libreria. Ecco come fare:

  1. Apri il tuo progetto: inizia aprendo il tuo progetto C# in Visual Studio o in qualsiasi altro IDE preferito.
  2. Aggiungere riferimenti: fare clic con il pulsante destro del mouse sul progetto in Esplora soluzioni, selezionare “Aggiungi”, quindi “Riferimento”.
  3. Cerca Aspose.Cells: individua il file Aspose.Cells.dll scaricato in precedenza e aggiungilo ai riferimenti del progetto. Questo passaggio è fondamentale poiché collega la funzionalità Aspose.Cells al progetto.
using System.IO;
using Aspose.Cells;
using System;

Ora che hai importato i pacchetti necessari, creeremo una cartella di lavoro Excel di esempio. In questa cartella di lavoro avremo più fogli, e uno di questi sarà nascosto per questo tutorial.

Passaggio 1: configura il tuo ambiente

Per prima cosa, impostiamo l’ambiente e specifichiamo i percorsi per il file di esempio.

// Percorso verso la directory dei documenti.
string dataDir = "Your Document Directory";
string sampleFile = "output.xlsx";
string samplePath = dataDir + sampleFile;

In questo frammento di codice, sostituisci"Your Document Directory" con il percorso effettivo in cui desideri salvare la cartella di lavoro.

Passaggio 2: creare la cartella di lavoro

Ora creiamo la cartella di lavoro e aggiungiamo alcuni dati.

// Crea una cartella di lavoro di esempio
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; // Rendi Sheet3 nascosto
createWorkbook.Save(samplePath);

Ecco una ripartizione di ciò che sta accadendo:

  • Stiamo creando una nuova cartella di lavoro e aggiungendo tre fogli.
  • “Sheet1” e “Sheet2” saranno visibili, mentre “Sheet3” sarà nascosto.
  • Salviamo quindi la cartella di lavoro nel percorso specificato.

Passaggio 3: caricare la cartella di lavoro di esempio con le opzioni di caricamento

Ora che abbiamo una cartella di lavoro con fogli visibili e nascosti, è il momento di caricarla assicurandoci di accedere solo ai fogli visibili.

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

Questo frammento di codice imposta le opzioni di caricamento per la cartella di lavoro, che personalizzeremo per filtrare i fogli nascosti.

Passaggio 4: definire il filtro di carico personalizzato

Per caricare solo i fogli visibili, dobbiamo creare un filtro di caricamento personalizzato. Ecco come definirlo:

class CustomLoad : LoadFilter
{
    public override void StartSheet(Worksheet sheet)
    {
        if (sheet.IsVisible)
        {
            this.LoadDataFilterOptions = LoadDataFilterOptions.All;
        }
        else
        {
            this.LoadDataFilterOptions = LoadDataFilterOptions.Structure;
        }
    }
}
  • ILStartSheet Il metodo controlla se ogni foglio è visibile.
  • Se è visibile, carica tutti i dati da quel foglio.
  • Se non è visibile, salta il caricamento dei dati da quel foglio.

Passaggio 5: caricare la cartella di lavoro utilizzando le opzioni di caricamento

Carichiamo ora la cartella di lavoro e visualizziamo i dati dai fogli visibili.

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);

Questo frammento di codice utilizza illoadOptions per importare solo i dati dai fogli visibili e visualizza il contenuto della cella A1 da “Foglio1” e “Foglio2”.

Conclusione

Ed ecco fatto! Hai imparato con successo come caricare solo fogli visibili da un file Excel usando Aspose.Cells per .NET. Gestire i tuoi fogli di lavoro Excel può essere un gioco da ragazzi quando sai come limitare i dati che recuperi e lavorare solo con quelli di cui hai bisogno. Questo non solo migliora l’efficienza delle tue applicazioni, ma rende anche il tuo codice più pulito e più facile da gestire.

Domande frequenti

Posso caricare fogli nascosti se necessario?

Sì, puoi semplicemente modificare le condizioni nel filtro di carico personalizzato per includere i fogli nascosti.

A cosa serve Aspose.Cells?

Aspose.Cells viene utilizzato per manipolare file Excel senza richiedere l’installazione di Microsoft Excel, offrendo funzionalità come la lettura, la scrittura e la gestione di fogli di lavoro Excel.

Esiste una versione di prova di Aspose.Cells?

Sì, puoiscarica una prova gratuita per testarne le caratteristiche.

Dove posso trovare la documentazione per Aspose.Cells?

ILdocumentazione fornisce informazioni complete su tutte le funzionalità.

Come posso acquistare Aspose.Cells?

Puoi facilmenteacquista Aspose.Cells dalla loro pagina di acquisto.

Mantieni i separatori per le righe vuote in Excel