La validation des données

Microsoft Excel fournit quelques bonnes fonctionnalités pour filtrer ou valider automatiquement les données de la feuille de calcul. 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

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.

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 entiers, c’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.
• Une heure se situe 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 :

1. Dans une feuille de calcul, sélectionnez les cellules auxquelles vous souhaitez appliquer la validation.
2. DuDonnées menu, sélectionnezValidation. La boîte de dialogue de validation s’affiche.
3. Clique leRéglages onglet et entrez les paramètres.

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 travail la classe a unValidationspropriété qui représente un ensemble deValidation objets. Pour configurer la validation, définissez certaines desValidationpropriétés de la classe comme suit :

• Type – 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.
• Formula1 – représente la valeur ou l’expression associée à la première partie de la validation des données.
• Formula2 – représente la valeur ou l’expression associée à la deuxième partie de la validation des données.

Quand leValidation les 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

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.
Lister	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 le temps.
Longueur du texte	Indique le type de validation pour la longueur du texte.
Personnalisé	Indique le type de validation personnalisé.

Validation des données de nombre entier

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 le type de validation WholeNumber. 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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a workbook object.
Workbook workbook = new Workbook();

// Create a worksheet and get the first worksheet.
Worksheet ExcelWorkSheet = workbook.Worksheets[0];

// Accessing the Validations collection of the worksheet
ValidationCollection validations = workbook.Worksheets[0].Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Creating a Validation object
Validation validation = validations[validations.Add(ca)];

// Setting the validation type to whole number
validation.Type = ValidationType.WholeNumber;

// Setting the operator for validation to Between
validation.Operator = OperatorType.Between;

// Setting the minimum value for the validation
validation.Formula1 = "10";

// Setting the maximum value for the validation
validation.Formula2 = "1000";

// Applying the validation to a range of cells from A1 to B2 using the
// CellArea structure
CellArea area;
area.StartRow = 0;
area.EndRow = 1;
area.StartColumn = 0;
area.EndColumn = 1;

// Adding the cell area to Validation
validation.AddArea(area);


// Save the workbook.
workbook.Save(dataDir + "output.out.xls");

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. Dans l’exemple, une deuxième feuille de calcul est ajoutée pour contenir la source de la liste. 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.InCellDropDown propriété àvrai.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a workbook object.
Workbook workbook = new Workbook();

// Get the first worksheet.
Worksheet worksheet1 = workbook.Worksheets[0];

// Add a new worksheet and access it.
int i = workbook.Worksheets.Add();
Worksheet worksheet2 = workbook.Worksheets[i];

// Create a range in the second worksheet.
Range range = worksheet2.Cells.CreateRange("E1", "E4");

// Name the range.
range.Name = "MyRange";

// Fill different cells with data in the range.
range[0, 0].PutValue("Blue");
range[1, 0].PutValue("Red");
range[2, 0].PutValue("Green");
range[3, 0].PutValue("Yellow");

// Get the validations collection.
ValidationCollection validations = worksheet1.Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Create a new validation to the validations list.
Validation validation = validations[validations.Add(ca)];

// Set the validation type.
validation.Type = Aspose.Cells.ValidationType.List;

// Set the operator.
validation.Operator = OperatorType.None;

// Set the in cell drop down.
validation.InCellDropDown = true;

// Set the formula1.
validation.Formula1 = "=MyRange";

// Enable it to show error.
validation.ShowError = true;

// Set the alert type severity level.
validation.AlertStyle = ValidationAlertType.Stop;

// Set the error title.
validation.ErrorTitle = "Error";

// Set the error message.
validation.ErrorMessage = "Please select a color from the list";

// Specify the validation area.
CellArea area;
area.StartRow = 0;
area.EndRow = 4;
area.StartColumn = 0;
area.EndColumn = 0;

// Add the validation area.
validation.AddArea(area);

// Save the Excel file.
workbook.Save(dataDir + "output.out.xls");

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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.Worksheets[0].Cells;

// Put a string value into the A1 cell.
cells["A1"].PutValue("Please enter Date b/w 1/1/1970 and 12/31/1999");

// Set row height and column width for the cells.
cells.SetRowHeight(0, 31);
cells.SetColumnWidth(0, 35);

// Get the validations collection.
ValidationCollection validations = workbook.Worksheets[0].Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Add a new validation.
Validation validation = validations[validations.Add(ca)];

// Set the data validation type.
validation.Type = ValidationType.Date;

// Set the operator for the data validation
validation.Operator = OperatorType.Between;

// Set the value or expression associated with the data validation.
validation.Formula1 = "1/1/1970";

// The value or expression associated with the second part of the data validation.
validation.Formula2 = "12/31/1999";

// Enable the error.
validation.ShowError = true;

// Set the validation alert style.
validation.AlertStyle = ValidationAlertType.Stop;

// Set the title of the data-validation error dialog box
validation.ErrorTitle = "Date Error";

// Set the data validation error message.
validation.ErrorMessage = "Enter a Valid Date";

// Set and enable the data validation input message.
validation.InputMessage = "Date Validation Type";
validation.IgnoreBlank = true;
validation.ShowInput = true;

// Set a collection of CellArea which contains the data validation settings.
CellArea cellArea;
cellArea.StartRow = 0;
cellArea.EndRow = 0;
cellArea.StartColumn = 1;
cellArea.EndColumn = 1;

// Add the validation area.
validation.AddArea(cellArea);

// Save the Excel file.
workbook.Save(dataDir + "output.out.xls");

Validation des données de temps

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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

// Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.Worksheets[0].Cells;

// Put a string value into A1 cell.
cells["A1"].PutValue("Please enter Time b/w 09:00 and 11:30 'o Clock");


// Set the row height and column width for the cells.
cells.SetRowHeight(0, 31);
cells.SetColumnWidth(0, 35);

// Get the validations collection.
ValidationCollection validations = workbook.Worksheets[0].Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Add a new validation.
Validation validation = validations[validations.Add(ca)];

// Set the data validation type.
validation.Type = ValidationType.Time;

// Set the operator for the data validation.
validation.Operator = OperatorType.Between;

// Set the value or expression associated with the data validation.
validation.Formula1 = "09:00";

// The value or expression associated with the second part of the data validation.
validation.Formula2 = "11:30";

// Enable the error.
validation.ShowError = true;

// Set the validation alert style.
validation.AlertStyle = ValidationAlertType.Information;

// Set the title of the data-validation error dialog box.
validation.ErrorTitle = "Time Error";

// Set the data validation error message.
validation.ErrorMessage = "Enter a Valid Time";

// Set and enable the data validation input message.
validation.InputMessage = "Time Validation Type";
validation.IgnoreBlank = true;
validation.ShowInput = true;

// Set a collection of CellArea which contains the data validation settings.
CellArea cellArea;
cellArea.StartRow = 0;
cellArea.EndRow = 0;
cellArea.StartColumn = 1;
cellArea.EndColumn = 1;

// Add the validation area.
validation.AddArea(cellArea);

// Save the Excel file.
workbook.Save(dataDir + "output.out.xls");

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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);

  // Create directory if it is not already present.
bool IsExists = System.IO.Directory.Exists(dataDir);
if (!IsExists)
    System.IO.Directory.CreateDirectory(dataDir);

// Create a new workbook.
Workbook workbook = new Workbook();

// Obtain the cells of the first worksheet.
Cells cells = workbook.Worksheets[0].Cells;

// Put a string value into A1 cell.
cells["A1"].PutValue("Please enter a string not more than 5 chars");


// Set row height and column width for the cell.
cells.SetRowHeight(0, 31);
cells.SetColumnWidth(0, 35);

// Get the validations collection.
ValidationCollection validations = workbook.Worksheets[0].Validations;

// Create Cell Area
CellArea ca = new CellArea();
ca.StartRow = 0;
ca.EndRow = 0;
ca.StartColumn = 0;
ca.EndColumn = 0;

// Add a new validation.
Validation validation = validations[validations.Add(ca)];

// Set the data validation type.
validation.Type = ValidationType.TextLength;

// Set the operator for the data validation.
validation.Operator = OperatorType.LessOrEqual;

// Set the value or expression associated with the data validation.
validation.Formula1 = "5";

// Enable the error.
validation.ShowError = true;

// Set the validation alert style.
validation.AlertStyle = ValidationAlertType.Warning;

// Set the title of the data-validation error dialog box.
validation.ErrorTitle = "Text Length Error";

// Set the data validation error message.
validation.ErrorMessage = " Enter a Valid String";

// Set and enable the data validation input message.
validation.InputMessage = "TextLength Validation Type";
validation.IgnoreBlank = true;
validation.ShowInput = true;

// Set a collection of CellArea which contains the data validation settings.
CellArea cellArea;
cellArea.StartRow = 0;
cellArea.EndRow = 0;
cellArea.StartColumn = 1;
cellArea.EndColumn = 1;

// Add the validation area.
validation.AddArea(cellArea);

// Save the Excel file.
workbook.Save(dataDir + "output.out.xls");

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

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// The path to the documents directory.
string dataDir = RunExamples.GetDataDir(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
// Instantiate the workbook from sample Excel file
Workbook workbook = new Workbook(dataDir+ "sample.xlsx");

// Access the first worksheet
Worksheet worksheet = workbook.Worksheets[0];

// Access Cell C1
// Cell C1 has the Decimal Validation applied on it.
// It can take only the values Between 10 and 20
Cell cell = worksheet.Cells["C1"];

// Enter 3 inside this cell
// Since it is not between 10 and 20, it should fail the validation
cell.PutValue(3);

// Check if number 3 satisfies the Data Validation rule applied on this cell
Console.WriteLine("Is 3 a Valid Value for this Cell: " + cell.GetValidationValue());

// Enter 15 inside this cell
// Since it is between 10 and 20, it should succeed the validation
cell.PutValue(15);

// Check if number 15 satisfies the Data Validation rule applied on this cell
Console.WriteLine("Is 15 a Valid Value for this Cell: " + cell.GetValidationValue());

// Enter 30 inside this cell
// Since it is not between 10 and 20, it should fail the validation again
cell.PutValue(30);

// Check if number 30 satisfies the Data Validation rule applied on this cell
Console.WriteLine("Is 30 a Valid Value for this Cell: " + cell.GetValidationValue());

Vérifiez si la validation dans la 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é. Un exemple de fichier de test peut être téléchargé à partir du lien suivant :

sampleValidation.xlsx

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
Workbook book = new Workbook(sourceDir + "sampleValidation.xlsx");
Worksheet sheet = book.Worksheets["Sheet1"];
Cells cells = sheet.Cells;
Cell a2 = cells["A2"];
Validation va2 = a2.GetValidation();
if (va2.InCellDropDown)
{
    Console.WriteLine("A2 is a dropdown");
}
else
{
    Console.WriteLine("A2 is NOT a dropdown");
}
Cell b2 = cells["B2"];
Validation vb2 = b2.GetValidation();
if (vb2.InCellDropDown)
{
    Console.WriteLine("B2 is a dropdown");
}
else
{
    Console.WriteLine("B2 is NOT a dropdown");
}
Cell c2 = cells["C2"];
Validation vc2 = c2.GetValidation();
if (vc2.InCellDropDown)
{
    Console.WriteLine("C2 is a dropdown");
}
else
{
    Console.WriteLine("C2 is NOT a dropdown");
}

Ajouter CellArea à la validation existante

Il peut y avoir des cas où vous voudrez peut-être ajouterZoneCelluleà l’existantValidation. Lorsque vous ajoutezZoneCellule en 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. LecheckIntersection Le paramètre indique s’il faut vérifier l’intersection d’une zone donnée avec des zones de validation existantes. Le mettre àfaux désactivera la vérification des autres zones. LecheckEdge Le 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.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// directories
string SourceDir = RunExamples.Get_SourceDirectory();
string outputDir = RunExamples.Get_OutputDirectory();

Workbook workbook = new Workbook(SourceDir + "ValidationsSample.xlsx");

// Access first worksheet.
Worksheet worksheet = workbook.Worksheets[0];

// Accessing the Validations collection of the worksheet
Validation validation = worksheet.Validations[0];

// Create your cell area.
CellArea cellArea = CellArea.CreateCellArea("D5", "E7");

// Adding the cell area to Validation
validation.AddArea(cellArea, false, false);

// Save the output workbook.
workbook.Save(outputDir + "ValidationsSample_out.xlsx");

Les fichiers Excel source et de sortie sont joints pour référence.

Fichier source

Fichier de sortie

Sujets avancés

• Obtenir la validation Cell dans les fichiers ODS
• Obtenez la validation appliquée sur un Cell
• Vérifiez que la valeur Cell satisfait aux règles de validation des données