Convalida dei dati
Tipi ed esecuzione della convalida dei dati
La 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. È possibile anche 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.
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è 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 decimali.
- I valori sono limitati a un elenco di valori. La convalida dell’elenco 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.
- Un’ora è all’interno di un intervallo specifico.
- Un testo è di una determinata lunghezza 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, seleziona Convalida. Verrà visualizzata la finestra di dialogo di convalida.
- Fai clic sulla scheda Impostazioni e inserisci le impostazioni.
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 Worksheet ha una proprietà Validations che rappresenta una raccolta di oggetti Validation. Per impostare la convalida, impostare alcune delle proprietà della classe Validation come segue:
- 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.
Quando le proprietà dell’oggetto Validation sono state configurate, gli sviluppatori possono utilizzare la struttura CellArea per memorizzare informazioni sull’intervallo di celle che verrà convalidato utilizzando la convalida creata.
Tipi di Convalida dei Dati
L’enumerazione ValidationType ha i seguenti membri:
| Nome Membr* | Descrizione |
|---|---|
| AnyValue | Denota un valore di qualsiasi tipo. |
| WholeNumber | Denota il tipo di convalida per i numeri interi. |
| Decimal | Indica il tipo di convalida per i numeri decimali. |
| List | Indica il tipo di convalida per elenchi a discesa. |
| Date | Indica il tipo di convalida per le date. |
| Time | Indica il tipo di convalida per l’ora. |
| TextLength | Indica il tipo di convalida per la lunghezza del testo. |
| Custom | Indica il tipo di convalida personalizzato. |
Convalida dei dati del numero intero
Con questo tipo di convalida, gli utenti possono inserire solo numeri interi entro un intervallo specificato nelle celle convalidare. Gli esempi di codice seguenti mostrano come implementare il tipo di convalida del numero intero. L’esempio crea la stessa convalida dei dati utilizzando Aspose.Cells che abbiamo creato usando Microsoft Excel sopra.
Convalida dei dati della lista
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. Nell’esempio, viene aggiunta un secondo foglio di lavoro per contenere la fonte dell’elenco. Gli utenti possono selezionare solo valori dall’elenco. L’area di convalida è l’intervallo di celle A1:A5 nel primo foglio di lavoro.
È importante qui impostare la proprietà Validation.InCellDropDown su true.
Convalida dei dati della 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.
Convalida dei dati dell’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.
Convalida della 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 le convalide dei dati sono implementate, la convalida può essere verificata assegnando valori diversi nelle celle. Cell.GetValidationValue può essere utilizzato per ottenere il risultato della convalida. L’esempio seguente illustra questa funzionalità con valori diversi. Il file di esempio può essere scaricato dal seguente link per il test:
sampleDataValidationRules.xlsx
Verifica se la convalida nella cella è a discesa
Come abbiamo visto, ci sono molti tipi di convalida che possono essere implementati all’interno di una cella. Se si desidera verificare se la convalida è a discesa o no, può essere utilizzata la proprietà Validation.InCellDropDown per testare questo. Il codice di esempio seguente dimostra l’uso di questa proprietà. Un file di esempio per il testing può essere scaricato dal seguente link:
Aggiungi CellArea alla convalida esistente
Potrebbero esserci casi in cui si desidera aggiungere CellArea a Validation esistenti. Quando si aggiunge CellArea utilizzando Validation.AddArea(CellArea cellArea), Aspose.Cells controlla tutte le aree esistenti per vedere se la nuova area esiste già. Se il file contiene un gran numero di convalide, si verifica un calo delle prestazioni. Per superare questo problema, l’API fornisce il metodo Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge). Il parametro checkIntersection indica se verificare l’intersezione di una data area con le aree di convalida esistenti. Impostarlo su false disabilita la verifica delle 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 si è sicuri che la nuova area non sia l’area in alto a sinistra, è possibile impostare questo parametro su false.
Il seguente frammento di codice dimostra l’uso del metodo Validation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) per aggiungere nuove CellArea alle Validation esistenti.
I file excel sorgente e di output sono allegati a scopo informativo.