Utilizzo di formati numerici incorporati in Excel a livello di programmazione
Introduzione
In questo tutorial, ti guideremo attraverso l’uso di formati numerici incorporati in Excel tramite Aspose.Cells per .NET. Tratteremo tutto, dall’impostazione del tuo ambiente all’applicazione di formati diversi come date, percentuali e valute. Che tu sia un professionista esperto o che tu stia solo muovendo i primi passi nell’ecosistema .NET, questa guida ti aiuterà a formattare le celle di Excel come un gioco da ragazzi.
Prerequisiti
Prima di immergerti, assicurati di avere quanto segue:
- Aspose.Cells per la libreria .NET installata. Puoiscaricalo qui.
- Conoscenza pratica del linguaggio C# e della programmazione .NET di base.
- Visual Studio o qualsiasi IDE .NET installato sul computer.
- Una licenza Aspose valida olicenza temporanea.
- Framework .NET installato (versione 4.0 o superiore).
Se ti manca qualcosa di quanto sopra, segui i link forniti per impostare tutto. Pronti? Passiamo alla parte divertente!
Importa pacchetti
Prima di iniziare il tutorial, assicurati di importare gli spazi dei nomi necessari per lavorare con Aspose.Cells per .NET:
using System.IO;
using Aspose.Cells;
using System;
Una volta importati, sei pronto per manipolare i file Excel in modo programmatico. Ora, tuffiamoci nella guida passo dopo passo!
Passaggio 1: crea o accedi alla tua cartella di lavoro Excel
In questo passaggio, creerai una nuova cartella di lavoro. Immagina di aprire un nuovo file Excel, solo che lo stai facendo tramite codice!
// Percorso verso la directory dei documenti.
string dataDir = "Your Document Directory";
// Creare la directory se non è già presente.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
System.IO.Directory.CreateDirectory(dataDir);
// Creazione di un'istanza di un oggetto Workbook
Workbook workbook = new Workbook();
Qui, stiamo semplicemente istanziando un nuovoWorkbook object. Questo funziona come il tuo file Excel, pronto per la manipolazione dei dati. Puoi anche caricare un file esistente specificandone il percorso.
Passaggio 2: accedi al foglio di lavoro
Le cartelle di lavoro di Excel possono contenere più fogli di lavoro. In questo passaggio, accederemo al primo foglio di lavoro nella tua cartella di lavoro:
Worksheet worksheet = workbook.Worksheets[0];
Stiamo ora accedendo al primo foglio di lavoro nella cartella di lavoro. Se hai bisogno di manipolare fogli aggiuntivi, puoi farvi riferimento usando il loro indice o nome.
Passaggio 3: aggiungere dati alle celle
Cominciamo ad aggiungere alcuni dati a celle specifiche. Per prima cosa, inseriremo la data di sistema corrente nella cella “A1”:
worksheet.Cells["A1"].PutValue(DateTime.Now);
Questa riga inserisce la data corrente nella cella A1. Abbastanza bello, vero? Immagina di farlo manualmente per centinaia di celle: sarebbe un incubo. Ora, passiamo alla formattazione!
Passaggio 4: formattare la data nella cella “A1”
Ora formattiamo la data in un formato più leggibile, come “15-ott-24”. È qui che Aspose.Cells dà il meglio di sé:
- Recupera lo stile della cella:
Style style = worksheet.Cells["A1"].GetStyle();
Qui, stiamo prendendo lo stile della cella A1. Pensate a questo come se stessimo prendendo la “moda” della cella prima di apportare modifiche. 2. Imposta il formato della data:
style.Number = 15;
Impostazione delNumber proprietà a 15 applica il formato data desiderato. Questo è un codice di formato numerico incorporato per visualizzare le date nel formato “g-mmm-aa”.
3. Applica lo stile alla cella:
worksheet.Cells["A1"].SetStyle(style);
Questa riga applica le modifiche di stile alla cella. Ora, invece di un formato data predefinito, vedrai qualcosa di molto più user-friendly come “15-Ott-24”.
Passaggio 5: aggiungere e formattare una percentuale nella cella “A2”
Passiamo alla formattazione delle percentuali. Immagina di voler inserire un valore e visualizzarlo come percentuale. In questo passaggio, aggiungeremo un valore numerico alla cella “A2” e lo formatteremo come percentuale:
- Inserisci valore numerico:
worksheet.Cells["A2"].PutValue(20);
Questo inserisce il numero 20 nella cella A2. Potresti pensare: “È solo un numero semplice, come faccio a trasformarlo in una percentuale?” Bene, stiamo per arrivarci. 2. Recupera lo stile e imposta il formato percentuale:
style = worksheet.Cells["A2"].GetStyle();
style.Number = 9; // Formato in percentuale
worksheet.Cells["A2"].SetStyle(style);
```
Setting the `Number` property to 9 applies the built-in percentage format. Now the value in A2 will be displayed as "2000%." (Yes, 20 is treated as 2000% in percentage formatting).
## Step 6: Add and Format Currency in Cell "A3"
Now, let’s add a numeric value in cell A3 and format it as currency. This is a common use case for financial reports.
1. Insert Numeric Value:
```csharp
worksheet.Cells["A3"].PutValue(2546);
Qui, aggiungiamo 2546 alla cella A3. Poi, formattiamo questo numero in modo che venga visualizzato come valuta. 2. Recupera lo stile e imposta il formato della valuta:
style = worksheet.Cells["A3"].GetStyle();
style.Number = 6; // Formato come valuta
worksheet.Cells["A3"].SetStyle(style);
Impostazione delNumber proprietà a 6 applica il formato valuta. Ora il valore nella cella A3 verrà visualizzato come “2.546,00”, completo di virgole e due cifre decimali.
Passaggio 7: salvare il file Excel
Ora che abbiamo applicato tutta la magia della formattazione, è il momento di salvare il file:
// Salvataggio del file Excel
workbook.Save(dataDir + "book1.out.xls", SaveFormat.Excel97To2003);
Questa riga salva il file Excel nel formato Excel 97-2003. È possibile modificare ilSaveFormatper soddisfare le tue esigenze. E proprio così, hai creato e formattato un file Excel in modo programmatico!
Conclusione
Congratulazioni! Hai imparato con successo come usare Aspose.Cells per .NET per applicare formati numerici predefiniti alle celle in un file Excel. Dalle date alle percentuali e alle valute, abbiamo trattato alcune delle esigenze di formattazione più comuni per l’elaborazione dei dati Excel. Ora, invece di formattare manualmente le celle, puoi automatizzare l’intero processo, risparmiando tempo e riducendo gli errori.
Domande frequenti
Posso applicare formati numerici personalizzati utilizzando Aspose.Cells per .NET?
Sì! Oltre ai formati incorporati, Aspose.Cells supporta anche formati numerici personalizzati. Puoi creare formati altamente specifici utilizzandoCustom proprietà nellaStyle classe.
Come posso formattare una cella come valuta con un simbolo specifico?
Per applicare un simbolo di valuta specifico, puoi utilizzare la formattazione personalizzata impostandoStyle.Custom proprietà.
Posso formattare intere righe o colonne?
Assolutamente! Puoi applicare stili a intere righe o colonne usandoRows OColumnscollezioni inWorksheet oggetto.
Come posso formattare più celle contemporaneamente?
Puoi usare ilRange oggetto per selezionare più celle e applicare stili a tutte contemporaneamente.
Per utilizzare Aspose.Cells è necessario che sia installato Microsoft Excel?
No, Aspose.Cells funziona indipendentemente da Microsoft Excel, quindi non è necessario che Excel sia installato sul computer.
