Specificare la compatibilità del file Excel a livello di programmazione in .NET

Introduzione

Nel mondo odierno basato sui dati, la gestione e la manipolazione dei file Excel a livello di programmazione sono diventate essenziali per molti sviluppatori. Se lavori con Excel in .NET, Aspose.Cells è una potente libreria che semplifica la creazione, la lettura, la modifica e il salvataggio dei file Excel. Una caratteristica importante di questa libreria ti consente di specificare la compatibilità dei file Excel a livello di programmazione. In questo tutorial, esploreremo come manipolare i file Excel, concentrandoci in particolare sulla gestione della compatibilità tramite Aspose.Cells per .NET. Alla fine, capirai come impostare la compatibilità per i file Excel, in particolare per le tabelle pivot, durante l’aggiornamento e la gestione dei dati.

Prerequisiti

Prima di immergerti nella fase di codifica, assicurati di avere quanto segue:

  1. Conoscenza di base di C#: poiché scriveremo codice in C#, avere familiarità con il linguaggio ti aiuterà a comprendere meglio il tutorial.
  2. Aspose.Cells per la libreria .NET: puoi scaricarla daPagina di rilascio di Aspose CellsSe non l’hai ancora fatto, prendi in considerazione l’idea di ottenere una prova gratuita per esplorarne prima le funzionalità.
  3. Visual Studio: un IDE in cui puoi scrivere e testare efficacemente il tuo codice C#.
  4. File Excel di esempio: assicurati di avere un file Excel di esempio, preferibilmente uno che contenga una tabella pivot per la demo. Per il nostro esempio, useremosample-pivot-table.xlsx.

Una volta soddisfatti questi prerequisiti, possiamo iniziare il processo di codifica.

Importa pacchetti

Prima di iniziare a scrivere la tua applicazione, devi includere i namespace necessari nel tuo codice per utilizzare efficacemente la libreria Aspose.Cells. Ecco come fare.

Importa lo spazio dei nomi Aspose.Cells

using System.IO;
using System;
using Aspose.Cells;
using Aspose.Cells.Pivot;
using System.Drawing;

Questa riga di codice garantisce l’accesso a tutte le classi e ai metodi all’interno della libreria Aspose.Cells.

Ora analizziamo il processo in dettaglio per assicurarci che tutto sia chiaro e comprensibile.

Passaggio 1: imposta la tua directory

Per prima cosa, imposta la directory in cui si trovano i tuoi file Excel. È importante fornire il percorso file corretto.

// Percorso verso la directory dei documenti.
string dataDir = "Your Document Directory";

Qui, sostituisci"Your Document Directory"con il percorso effettivo dei tuoi file Excel. È qui che dovrebbe risiedere il file della tabella pivot di esempio.

Passaggio 2: caricare il file Excel di origine

Successivamente, dobbiamo caricare il file Excel che contiene la tabella pivot di esempio.

// Carica il file Excel di origine contenente la tabella pivot di esempio
Workbook wb = new Workbook(dataDir + "sample-pivot-table.xlsx");

In questo passaggio, creiamo un’istanza diWorkbook classe, che carica il file Excel specificato.

Passaggio 3: accedi ai fogli di lavoro

Ora che la cartella di lavoro è caricata, è necessario accedere al foglio di lavoro che contiene i dati della tabella pivot.

// Accedi al primo foglio di lavoro contenente i dati della tabella pivot
Worksheet dataSheet = wb.Worksheets[0];

Qui, accediamo al primo foglio di lavoro in cui si trova la tabella pivot. Puoi anche scorrere o specificare altri fogli di lavoro in base alla tua struttura Excel.

Passaggio 4: manipolare i dati delle celle

Il passo successivo è modificare alcuni valori delle celle nel foglio di lavoro.

Passaggio 4.1: Modifica la cella A3

Cominciamo accedendo alla cella A3 e impostandone il valore.

// Accedi alla cella A3 e imposta i suoi dati
Cells cells = dataSheet.Cells;
Cell cell = cells["A3"];
cell.PutValue("FooBar");

Questo frammento di codice aggiorna la cella A3 con il valore “FooBar”.

Passaggio 4.2: Modificare la cella B3 con una stringa lunga

Ora impostiamo una stringa lunga nella cella B3, che superi i limiti di caratteri standard di Excel.

// Accedi alla cella B3, imposta i suoi dati
string longStr = "Very long text 1. very long text 2.... [continue your long string]";
cell = cells["B3"];
cell.PutValue(longStr);

Questo codice è importante perché definisce le aspettative in merito ai limiti dei dati, soprattutto quando si lavora con le impostazioni di compatibilità in Excel.

Passaggio 5: controllare la lunghezza della cella B3

È inoltre essenziale confermare la lunghezza della stringa immessa.

// Stampa la lunghezza della stringa della cella B3
Console.WriteLine("Length of original data string: " + cell.StringValue.Length);

Questo serve solo per verificare quanti caratteri sono memorizzati sul tuo cellulare.

Passaggio 6: imposta altri valori delle celle

Ora accederemo ad altre celle e imposteremo alcuni valori.

// Accedi alla cella C3 e imposta i suoi dati
cell = cells["C3"];
cell.PutValue("closed");

// Accedi alla cella D3 e imposta i suoi dati
cell = cells["D3"];
cell.PutValue("2016/07/21");

Ognuno di questi frammenti aggiorna diverse celle aggiuntive all’interno del foglio di lavoro.

Passaggio 7: accedere alla tabella pivot

Successivamente, accederai al secondo foglio di lavoro, contenente i dati della tabella pivot.

//Accedi al secondo foglio di lavoro che contiene la tabella pivot
Worksheet pivotSheet = wb.Worksheets[1];

// Accedi alla tabella pivot
PivotTable pivotTable = pivotSheet.PivotTables[0];

Questo frammento consente di manipolare la tabella pivot per le impostazioni di compatibilità.

Passaggio 8: impostare la compatibilità per Excel 2003

È fondamentale stabilire se la tabella pivot è compatibile o meno con Excel 2003.

// La proprietà IsExcel2003Compatible indica se la tabella pivot è compatibile con Excel2003 durante l'aggiornamento della tabella pivot
pivotTable.IsExcel2003Compatible = true;
pivotTable.RefreshData();
pivotTable.CalculateData();

È qui che inizia la vera trasformazione. ImpostandoIsExcel2003Compatible Atrue, puoi limitare la lunghezza dei caratteri a 255 durante l’aggiornamento.

Passaggio 9: controllare la lunghezza dopo l’impostazione di compatibilità

Dopo aver impostato la compatibilità, vediamo come influisce sui dati.

// Controllare il valore della cella B5 del foglio pivot.
Cell b5 = pivotSheet.Cells["B5"];
Console.WriteLine("Length of cell B5 after setting IsExcel2003Compatible property to True: " + b5.StringValue.Length);

Probabilmente vedrai un output che conferma l’effetto del troncamento se i dati iniziali superano i 255 caratteri.

Passaggio 10: modifica le impostazioni di compatibilità

Ora modifichiamo le impostazioni di compatibilità e verifichiamo di nuovo.

//Ora imposta la proprietà IsExcel2003Compatible su false e aggiorna di nuovo
pivotTable.IsExcel2003Compatible = false;
pivotTable.RefreshData();
pivotTable.CalculateData();

Ciò consente ai dati di rispecchiare la loro lunghezza originale senza le restrizioni precedenti.

Passaggio 11: verificare nuovamente la lunghezza

Verifichiamo che i dati ora riflettano accuratamente la loro lunghezza reale.

// Ora stamperà la lunghezza originale dei dati della cella. I dati non sono stati troncati ora.
b5 = pivotSheet.Cells["B5"];
Console.WriteLine("Length of cell B5 after setting IsExcel2003Compatible property to False: " + b5.StringValue.Length);

Dovresti vedere che l’output conferma la rimozione del troncamento.

Passaggio 12: formattare le celle

Per migliorare l’esperienza visiva, potresti voler formattare le celle.

// Imposta l'altezza della riga e la larghezza della colonna della cella B5 e anche il suo testo
pivotSheet.Cells.SetRowHeight(b5.Row, 100);
pivotSheet.Cells.SetColumnWidth(b5.Column, 65);
Style st = b5.GetStyle();
st.IsTextWrapped = true;
b5.SetStyle(st);

Queste righe di codice facilitano la lettura dei dati regolando le dimensioni delle celle e abilitando l’interruzione di pagina del testo.

Passaggio 13: Salvare la cartella di lavoro

Infine, salva la cartella di lavoro con le modifiche apportate.

// Salva la cartella di lavoro in formato xlsx
wb.Save(dataDir + "SpecifyCompatibility_out.xlsx", SaveFormat.Xlsx);

La scelta di un formato di file appropriato è fondamentale quando si salvano file Excel.XlsxIl formato è ampiamente utilizzato e compatibile con molte versioni di Excel.

Conclusione

Congratulazioni! Ora hai programmato le impostazioni di compatibilità dei file Excel usando Aspose.Cells per .NET. Questo tutorial ha delineato ogni passaggio, dalla configurazione dell’ambiente alla modifica delle impostazioni di compatibilità per le tabelle pivot. Se hai mai lavorato con dati che richiedevano limitazioni o compatibilità specifiche, questa è un’abilità che non vorrai trascurare.

Domande frequenti

Che cos’è Aspose.Cells?

Aspose.Cells è una libreria .NET progettata per aiutare gli sviluppatori a creare, manipolare e convertire file Excel senza problemi.

Perché è importante la compatibilità con Excel?

La compatibilità con Excel è fondamentale per garantire che i file possano essere aperti e utilizzati nelle versioni previste di Excel, in particolare se contengono funzionalità o formati non supportati nelle versioni precedenti.

Posso creare tabelle pivot a livello di programmazione con Aspose.Cells?

Sì, puoi creare e manipolare le tabelle pivot a livello di programmazione usando Aspose.Cells. La libreria fornisce vari metodi per aggiungere origini dati, campi e funzionalità associate alle tabelle pivot.

Come faccio a controllare la lunghezza di una stringa in una cella di Excel?

Puoi usare ilStringValue proprietà di unCell oggetto per ottenere il contenuto della cella e quindi chiamare il.Length proprietà per scoprire la lunghezza della stringa.

Posso personalizzare la formattazione delle celle oltre all’altezza e alla larghezza delle righe?

Assolutamente! Aspose.Cells consente una formattazione estesa delle celle. Puoi cambiare stili di carattere, colori, bordi, formati numerici e molto altro tramiteStyle classe.

Mostra l'opzione delle pagine del filtro report in .NET Specificare l'origine dati della connessione esterna in .NET