La validation des données
Microsoft Excel fournit de bonnes fonctionnalités pour filtrer automatiquement ou valider les données de la feuille de calcul.
La validation des données est la possibilité de définir des règles relatives aux données saisies sur une feuille de calcul. Par exemple, utilisez la validation pour vous assurer qu’une colonne intitulée DATE ne contient que des dates ou qu’une autre colonne ne contient que des nombres. Vous pouvez même vous assurer qu’une colonne intitulée DATE ne contient que des dates comprises dans une certaine plage. Avec la validation des données, vous pouvez contrôler ce qui est entré dans les cellules de la feuille de calcul. Aspose.Cells prend entièrement en charge les fonctions de validation et de filtrage automatique des données d’Excel Microsoft. Cet article explique comment utiliser les fonctionnalités dans Microsoft Excel et comment les coder à l’aide de Aspose.Cells.
Types de validation des données et exécution
Microsoft Excel prend en charge un certain nombre de différents types de validation de données. Chaque type est utilisé pour contrôler le type de données saisies dans une cellule ou une plage de cellules. Ci-dessous, des extraits de code illustrent comment valider cela :
- Numbers sont entiersc’est-à-dire qu’ils n’ont pas de partie décimale.
- Les nombres décimaux suivent la bonne structure. L’exemple de code définit qu’une plage de cellules doit avoir deux espaces décimaux.
- Les valeurs sont limitées à une liste de valeurs. La validation de liste définit une liste distincte de valeurs qui peuvent être appliquées à une cellule ou à une plage de cellules.
- Les dates se situent dans une plage spécifique.
- Le temps est dans une plage spécifique.
- Un texte est dans une longueur de caractère donnée.
Validation des données avec Microsoft Excel
Pour créer des validations à l’aide de Microsoft Excel :
-
Dans une feuille de calcul, sélectionnez les cellules auxquelles vous souhaitez appliquer la validation.
-
DuDonnéesmenu, sélectionnezValidation. La boîte de dialogue de validation s’affiche.
-
Clique leRéglageset entrez les paramètres comme indiqué ci-dessous.
Paramètres de validation des données
Validation des données avec Aspose.Cells
La validation des données est une fonctionnalité puissante pour valider les informations saisies dans les feuilles de calcul. Avec la validation des données, les développeurs peuvent fournir aux utilisateurs une liste de choix, limiter les entrées de données à un type ou une taille spécifique, etc. Au Aspose.Cells, chaqueFeuille de travailla classe a unValidationsobjet qui représente une collection deValidationobjets. Pour configurer la validation, définissez certaines desValidationpropriétés de la classe :
- Taper: représente le type de validation, qui peut être spécifié en utilisant l’une des valeurs prédéfinies dans leValidationTypeénumération.
- Opérateur: représente l’opérateur à utiliser dans la validation, qui peut être spécifié en utilisant l’une des valeurs prédéfinies dans leType d’opérateurénumération.
- Formule 1: représente la valeur ou l’expression associée à la première partie de la validation des données.
- Formule2: représente la valeur ou l’expression associée à la deuxième partie de la validation des données.
Quand leValidationles propriétés de l’objet ont été configurées, les développeurs peuvent utiliser leZoneCellulestructure pour stocker des informations sur la plage de cellules qui seront validées à l’aide de la validation créée.
Types de validation des données
La validation des données vous permet de créer des règles métier dans chaque cellule afin que des entrées incorrectes entraînent des messages d’erreur. Les règles métier sont les politiques et procédures qui régissent le fonctionnement d’une entreprise. Aspose.Cells prend en charge tous les types importants de validation de données.
LeValidationTypeénumération a les membres suivants :
| Nom de membre | Description |
|---|---|
| DE N’IMPORTE QUELLE VALEUR | Indique une valeur de n’importe quel type. |
| NOMBRE ENTIER | Indique le type de validation pour les nombres entiers. |
| DÉCIMAL | Indique le type de validation pour les nombres décimaux. |
| LISTE | Indique le type de validation pour la liste déroulante. |
| DATE | Indique le type de validation des dates. |
| TEMPS | Indique le type de validation pour Time. |
| TEXT_LENGTH | Indique le type de validation pour la longueur du texte. |
| DOUANE | Indique le type de validation personnalisé. |
Exemple de programmation : validation des données de nombres entiers
Avec ce type de validation, les utilisateurs ne peuvent entrer que des nombres entiers dans une plage spécifiée dans les cellules validées. Les exemples de code qui suivent montrent comment implémenter leNOMBRE ENTIERtype de validation. L’exemple crée la même validation de données en utilisant Aspose.Cells que nous avons créée en utilisant Microsoft Excel ci-dessus.
Exemple de programmation : validation des données décimales
Avec ce type de validation, l’utilisateur peut entrer des nombres décimaux dans les cellules validées. Dans l’exemple, l’utilisateur est limité à la saisie de valeurs décimales uniquement et la zone de validation est A1:A10.
Exemple de programmation : Validation des données de liste
Ce type de validation permet à l’utilisateur de saisir des valeurs à partir d’une liste déroulante. Il fournit une liste : une série de lignes contenant des données. Les utilisateurs ne peuvent sélectionner que des valeurs dans la liste. La zone de validation est la plage de cellules A1:A5 dans la première feuille de calcul.
Il est important ici que vous définissiezValidation.setInCellDropDown propriété àvrai.
Exemple de programmation : validation des données de date
Avec ce type de validation, les utilisateurs entrent des valeurs de date dans une plage spécifiée ou répondant à des critères spécifiques dans les cellules validées. Dans l’exemple, l’utilisateur est limité à saisir des dates entre 1970 et 1999. Ici, la zone de validation est la cellule B1.
Exemples de programmation : validation des données temporelles
Avec ce type de validation, les utilisateurs peuvent entrer des heures dans une plage spécifiée ou répondant à certains critères dans les cellules validées. Dans l’exemple, l’utilisateur est limité à saisir des heures entre 09h00 et 11h30. Ici, la zone de validation est la cellule B1.
Exemples de programmation : validation des données de longueur de texte
Avec ce type de validation, les utilisateurs peuvent entrer des valeurs de texte d’une longueur spécifiée dans les cellules validées. Dans l’exemple, l’utilisateur est limité à saisir des valeurs de chaîne ne dépassant pas 5 caractères. La zone de validation est la cellule B1.
Règles de validation des données
Lorsque les validations de données sont mises en œuvre, la validation peut être vérifiée en attribuant différentes valeurs dans les cellules.Cell.GetValidationValue() peut être utilisé pour récupérer le résultat de la validation. L’exemple suivant illustre cette fonctionnalité avec différentes valeurs. Le fichier d’exemple peut être téléchargé à partir du lien suivant pour le test :
SampleDataValidationRules.xlsx
Exemple de code
Vérifier si la validation dans une cellule est déroulante
Comme nous l’avons vu, il existe de nombreux types de validations qui peuvent être mises en œuvre au sein d’une cellule. Si vous voulez vérifier si la validation est déroulante ou non,Validation.InCellDropDown propriété peut être utilisée pour tester cela. L’exemple de code suivant illustre l’utilisation de cette propriété. Le fichier d’exemple pour les tests peut être téléchargé à partir du lien suivant :
sampleDataValidationRules.xlsx
Ajouter CellArea à la validation existante
Il peut y avoir des cas où vous voudrez peut-être ajouterZoneCelluleà l’existantValidation. Lorsque vous ajoutezZoneCelluleen utilisantValidation.AddArea(CellArea cellArea), Aspose.Cells vérifie toutes les zones existantes pour voir si la nouvelle zone existe déjà. Si le fichier a un grand nombre de validations, cela affecte les performances. Pour surmonter cela, le API fournit leValidation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) méthode. LecheckIntersectionLe paramètre indique s’il faut vérifier l’intersection d’une zone donnée avec des zones de validation existantes. Le mettre àfauxdésactivera la vérification des autres zones. LecheckEdgeLe paramètre indique s’il faut vérifier les zones appliquées. Si la nouvelle zone devient la zone supérieure gauche, les paramètres internes sont reconstruits. Si vous êtes sûr que la nouvelle zone n’est pas la zone en haut à gauche, vous pouvez définir ce paramètre commefaux.
L’extrait de code suivant illustre l’utilisation deValidation.AddAreaCellArea cellArea, bool checkIntersection, bool checkEdge) méthode pour ajouter de nouveauxZoneCelluleà l’existantValidation.
Les fichiers Excel source et de sortie sont joints pour référence.