Ajouter des validations de cellules

Une des fonctionnalités avancées d’Aspose.Cells.GridWeb est d’ajouter des règles de validation d’entrée pour les cellules. Les développeurs peuvent créer différents types de règles de validation pour les cellules afin de contrôler et valider les valeurs d’entrée. Ce sujet aborde les types de validation pris en charge et comment les créer.

Types de validations

Trois types de validations peuvent être appliqués à l’aide d’Aspose.Cells.GridWeb :

• Validation de liste.
• Validation de liste déroulante.
• Validation d’expression personnalisée.

Chacun est discuté en détail ci-dessous.

Validation de liste

La validation de liste permet aux utilisateurs de fournir une entrée de cellule soit en tapant, soit en sélectionnant une valeur dans un menu. Pour créer une validation de liste pour une cellule :

1. Ajoutez le contrôle Aspose.Cells.GridWeb à un formulaire Web.
2. Accéder à une feuille de calcul.
3. Accédez à la cellule pour ajouter la validation.
4. Créez la validation pour la cellule et spécifiez le type de validation comme List.
5. Ajoutez des valeurs pour la validation de la liste.

Le code exemple ajoute une validation de liste à C1. Lorsqu’un utilisateur clique sur la cellule, une liste apparaît.

Résultat : sélection d’une valeur dans la liste

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the cells collection of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Access "B1" cell and add some text
GridCell cell = sheet.Cells[0, 1];
cell.PutValue("Select Course:");

// Accessing "C1" cell
cell = sheet.Cells[0, 2];

// Creating List validation for the "C1" cell
var validation = cell.CreateValidation(GridValidationType.List, true);

// Adding values to List validation
var values = new System.Collections.Specialized.StringCollection();
values.Add("Fortran");
values.Add("Pascal");
values.Add("C++");
values.Add("Visual Basic");
values.Add("Java");
values.Add("C#");
validation.ValueList = values;

Validation de liste déroulante

La validation de liste déroulante permet aux utilisateurs de fournir une entrée pour les cellules en sélectionnant une valeur dans une liste prédéfinie. Pour créer une validation de liste déroulante :

1. Ajoutez le contrôle Aspose.Cells.GridWeb à un formulaire Web.
2. Accéder à une feuille de calcul.
3. Accédez à la cellule pour créer la validation.
4. Créez une validation pour la cellule et spécifiez le type comme DropDownList.
5. Ajoutez des valeurs pour la validation.

L’exemple de code ajoute une validation de liste déroulante à C1. Lorsqu’un utilisateur clique sur la cellule, une liste déroulante apparaît et les utilisateurs peuvent sélectionner une valeur.

Sélectionner une valeur dans une liste déroulante

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the cells collection of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Access "B1" cell and add some text
GridCell cell = sheet.Cells[0, 1];
cell.PutValue("Select Degree:");

// Accessing "C1" cell
cell = sheet.Cells[0, 2];

// Creating DropDownList validation for the "C1" cell
var validation = cell.CreateValidation(GridValidationType.DropDownList, true);
            
// Adding values to DropDownList validation
var values = new System.Collections.Specialized.StringCollection();
values.Add("Bachelor");
values.Add("Master");
values.Add("Doctor");
validation.ValueList = values;

Validation d’expression personnalisée

La validation d’expression personnalisée permet aux développeurs d’écrire leurs propres expressions régulières personnalisées pour valider les valeurs d’entrée. Pour créer une validation d’expression personnalisée :

1. Ajoutez le contrôle Aspose.Cells.GridWeb à un formulaire Web.
2. Accéder à une feuille de calcul.
3. Accédez à la cellule pour créer une validation.
4. Créez une validation pour la cellule et spécifiez le type comme CustomExpression.
5. Définissez l’expression régulière de la validation.

Le code exemple ajoute une validation d’expression personnalisée à C1. Les utilisateurs ne peuvent ajouter qu’une date dans la cellule selon le format spécifié par l’expression régulière.

Ajout d’une valeur de date à C1 selon une expression régulière

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the cells collection of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

// Access "B1" cell and add some text
GridCell cell = sheet.Cells[0, 1];
cell.PutValue("Date (yyyy-mm-dd):");

// Access "C1" cell and add to it custom expression validation to accept dates in yyyy-mm-dd format
cell = sheet.Cells[0, 2];
var validation = cell.CreateValidation(GridValidationType.CustomExpression, true);
validation.RegEx = @"\d{4}-\d{2}-\d{2}";

Forcer la validation

En utilisant Aspose.Cells.GridWeb, les utilisateurs peuvent envoyer des données d’entrée à un serveur. Même s’il existe des règles de validation pour différentes cellules, si la propriété ForceValidation du contrôle GridWeb n’est pas définie sur true, les données d’entrée incorrectes seront tout de même soumises au serveur et aucune validation ne sera forcée. La propriété ForceValidation de GridWeb est toujours définie sur true par défaut.

Lorsque la propriété ForceValidation est true, le contrôle ne soumet pas les données au serveur web tant que les valeurs d’entrée de toutes les cellules ne sont pas valides. Par exemple, si quelqu’un entre une valeur d’entrée incorrecte dans une cellule, ou ne saisit pas de valeur, la validation côté client est activée et les utilisateurs ne peuvent pas envoyer de données même s’ils cliquent sur Soumettre.

Valeur d’entrée incorrecte surlignée par GridWeb