Convalida dei dati
Microsoft Excel fornisce alcune ottime funzionalità per filtrare automaticamente o convalidare i dati del foglio di lavoro.
Convalida dei dati è la capacità di impostare regole relative ai dati inseriti in un foglio di lavoro. Ad esempio, utilizzare la convalida per garantire che una colonna denominata DATA contenga solo date, o che un’altra colonna contenga solo numeri. È persino possibile garantire che una colonna denominata DATA contenga solo date entro un determinato intervallo. Con la convalida dei dati, è possibile controllare cosa viene inserito nelle celle del foglio di lavoro. Aspose.Cells supporta pienamente la convalida dei dati e le funzioni di autofiltro di Microsoft Excel. Questo articolo spiega come utilizzare le funzionalità in Microsoft Excel e come codificarle utilizzando Aspose.Cells.
Tipi ed esecuzione della convalida dei dati
Microsoft Excel supporta diversi tipi di convalida dei dati. Ogni tipo viene utilizzato per controllare quale tipo di dati viene inserito in una cella o in un intervallo di celle. Di seguito, frammenti di codice illustrano come convalidare che:
- I numeri sono interi, cioè, che non hanno una parte decimale.
- I numeri decimali seguono la struttura corretta. L’esempio di codice definisce che un intervallo di celle dovrebbe avere due posizioni decimali.
- I valori sono limitati a un elenco di valori. La convalida della lista definisce un elenco separato di valori che possono essere applicati a una cella o a un intervallo di celle.
- Le date rientrano in un intervallo specifico.
- L’ora rientra in un intervallo specifico.
- Un testo rientra in una data lunghezza specifica di caratteri.
Convalida dei dati con Microsoft Excel
Per creare convalide utilizzando Microsoft Excel:
-
In un foglio di lavoro, selezionare le celle a cui si desidera applicare la convalida.
-
Dal menu Dati, selezionare Convalida. Viene visualizzata la finestra di dialogo di convalida.
-
Fare clic sulla scheda Impostazioni e immettere le impostazioni come mostrato di seguito.
Impostazioni di convalida dei dati
Convalida dei dati con Aspose.Cells
La convalida dei dati è una funzionalità potente per convalidare le informazioni inserite nei fogli di lavoro. Con la convalida dei dati, gli sviluppatori possono fornire agli utenti un elenco di scelte, limitare le voci di dati a un tipo o dimensione specifici, ecc. In Aspose.Cells, ogni classe Foglio di lavoro ha un oggetto Convalida che rappresenta una raccolta di oggetti Convalida. Per impostare la convalida, impostare alcune proprietà della classe Convalida:
- Tipo: rappresenta il tipo di convalida, che può essere specificato utilizzando uno dei valori predefiniti nell’enumerazione ValidationType.
- Operatore: rappresenta l’operatore da utilizzare nella convalida, che può essere specificato utilizzando uno dei valori predefiniti nell’enumerazione OperatorType.
- Formula1: rappresenta il valore o l’espressione associata alla prima parte della convalida dei dati.
- Formula2: rappresenta il valore o l’espressione associata alla seconda parte della convalida dei dati.
Una volta configurate le proprietà dell’oggetto Convalida, gli sviluppatori possono utilizzare la struttura CellArea per memorizzare informazioni sul intervallo di celle che verrà convalidato utilizzando la convalida creata.
Tipi di Convalida dei Dati
La convalida dei dati consente di integrare regole aziendali in ciascuna cella in modo che le voci non corrette generino messaggi di errore. Le regole aziendali sono le politiche e le procedure che regolano il funzionamento di un’azienda. Aspose.Cells supporta tutti i principali tipi di convalida dei dati.
L’enumerazione ValidationType ha i seguenti membri:
| Nome Membr* | Descrizione |
|---|---|
| ANY_VALUE | Indica un valore di qualsiasi tipo. |
| WHOLE_NUMBER | Indica il tipo di convalida per numeri interi. |
| DECIMAL | Indica il tipo di convalida per i numeri decimali. |
| LIST | Indica il tipo di convalida per elenco a discesa. |
| DATE | Indica il tipo di convalida per le date. |
| TIME | Indica il tipo di convalida per l’ora. |
| TEXT_LENGTH | Indica il tipo di convalida per la lunghezza del testo. |
| CUSTOM | Indica il tipo di convalida personalizzato. |
Esempio di programmazione: convalida dati numerici interi
Con questo tipo di convalida, gli utenti possono inserire solo numeri interi all’interno di un intervallo specificato nelle celle con convalida. Gli esempi di codice seguenti mostrano come implementare il tipo di convalida WHOLE_NUMBER. L’esempio crea la stessa convalida dei dati utilizzando Aspose.Cells come abbiamo fatto con Microsoft Excel sopra.
Esempio di programmazione: convalida dati decimali
Con questo tipo di convalida, l’utente può inserire numeri decimali nelle celle convalidate. Nell’esempio, all’utente è vietato inserire solo valori decimali e l’area di convalida è A1:A10.
Esempio di programmazione: convalida dati di elenco
Questo tipo di convalida consente all’utente di inserire valori da un elenco a discesa. Fornisce un elenco: una serie di righe che contengono dati. Gli utenti possono selezionare solo valori dall’elenco. L’area di convalida è l’intervallo di celle A1:A5 nel primo foglio di lavoro.
È importante impostare la proprietà Validation.setInCellDrown su true.
Esempio di programmazione: convalida dati di data
Con questo tipo di convalida, gli utenti inseriscono valori di data entro un intervallo specificato, o che soddisfano determinati criteri, nelle celle convalidate. Nell’esempio, all’utente è vietato inserire date comprese tra il 1970 e il 1999. Qui, l’area di convalida è la cella B1.
Esempi di programmazione: convalida dati di ora
Con questo tipo di convalida, gli utenti possono inserire orari entro un intervallo specificato, o soddisfare alcuni criteri, nelle celle convalidate. Nell’esempio, all’utente è vietato inserire orari tra le 09:00 e le 11:30 del mattino. Qui, l’area di convalida è la cella B1.
Esempi di programmazione: convalida dati di lunghezza del testo
Con questo tipo di convalida, gli utenti possono inserire valori di testo di una lunghezza specificata nelle celle convalidate. Nell’esempio, all’utente è vietato inserire valori di stringa con più di 5 caratteri. L’area di convalida è la cella B1.
Regole di convalida dei dati
Quando vengono implementate le convalide dei dati, è possibile verificarle assegnando valori diversi nelle celle. Cell.GetValidationValue() può essere usato per recuperare il risultato della convalida. L’esempio seguente dimostra questa funzione con valori diversi. Il file di esempio può essere scaricato dal link seguente per i test:
SampleDataValidationRules.xlsx
Codice di Esempio
Verifica se la convalida in una cella è una selezione a discesa
Come abbiamo visto ci sono molti tipi di convalide che possono essere implementati all’interno di una cella. Se si desidera verificare se la convalida è una selezione a discesa o meno, Validation.InCellDropDown può essere utilizzato per testare questo. Il seguente codice di esempio dimostra l’utilizzo di questa proprietà. Il file di esempio per il test può essere scaricato dal seguente link:
sampleDataValidationRules.xlsx
Aggiungi CellArea alla convalida esistente
Potrebbero esserci casi in cui si desidera aggiungere CellArea alle Validation esistenti. Quando si aggiunge CellArea usando Validation.AddArea(CellArea cellArea), Aspose.Cells verifica tutte le aree esistenti per vedere se l’area nuova esiste già. Se il file ha molte validazioni, ciò può influire sulle prestazioni. Per superare questo, l’API fornisce il metodo Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge). Il parametro checkIntersection indica se verificare l’intersezione di un’area data con le aree di validazione esistenti. Impostarlo a false disabiliterà la verifica di altre aree. Il parametro checkEdge indica se verificare le aree applicate. Se la nuova area diventa l’area in alto a sinistra, le impostazioni interne vengono ricostruite. Se sei sicuro che la nuova area non sia l’area in alto a sinistra, puoi impostare questo parametro a false.
Il seguente frammento di codice dimostra l’uso del metodo Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) per aggiungere una nuova CellArea a una Validation esistente.
I file excel sorgente e di output sono allegati a scopo informativo.