Travailler avec la validation des données

Travailler avec la validation des données

Aspose.Cells FOSS for C++ supports adding cell-level data validation rules to worksheets via the Validation et ValidationCollection Les classes, le WorkbookValidator La classe fournit un contrôle de conséquences pré-sauvée.

Ajouter une règle de validation

Accès à la collection de validation pour un feuille de travail et ajoutez une nouvelle règle en utilisant ValidationCollection::Add().Configurez le type, la formule et l’espace cible sur le retourné Validation Objet :

#include "aspose/cells_foss/Workbook.h"
#include "aspose/cells_foss/Worksheet.h"
#include "aspose/cells_foss/ValidationCollection.h"
#include "aspose/cells_foss/Validation.h"
#include "aspose/cells_foss/CellArea.h"

using namespace Aspose::Cells_FOSS;

int main() {
    Workbook workbook;
    Worksheet& sheet = workbook.GetWorksheets()[0];
    ValidationCollection& validations = sheet.GetValidations();

    int idx = validations.Add();
    Validation& v = validations[idx];

    v.SetType(ValidationType::WholeNumber);
    v.SetFormula1("1");
    v.SetFormula2("100");
    v.SetIgnoreBlank(true);
    v.SetInCellDropDown(false);
    v.SetInputTitle("Enter Value");
    v.SetInputMessage("Value must be between 1 and 100.");
    v.SetErrorTitle("Invalid Input");
    v.SetErrorMessage("Value is out of range.");
    v.SetShowInput(true);
    v.SetShowError(true);

    CellArea area = CellArea::CreateCellArea("B2", "B10");
    v.AddArea(area);

    workbook.Save("validated.xlsx");
    return 0;
}

Types de validation

Le ValidationType L’enumeration définit les types de restrictions qui peuvent être appliquées :

Style de l’alerte

Le ValidationAlertType L’enumeration contrôle le comportement indiqué lorsque la validation échoue :

Définir le style d’alerte avec Validation::SetAlertStyle(ValidationAlertType).

- Validation de la demande dans une cellule

Utiliser ValidationCollection::GetValidationInCell(row, col) pour savoir quelle règle de validation s’applique à une cellule spécifique. nullptr Si aucune règle n’est appliquée.

Suppression des règles de validation

Supprimer une validation d’une cellule ou de la zone spécifique :

CellArea area = CellArea::CreateCellArea("B2", "B10");
validations.RemoveArea(area);
// Or remove a single cell:
validations.RemoveACell(1, 1); // row=1, col=1 (0-based)

Validation du livre de travail pré-save

Appel à WorkbookValidator::ValidateForSave pour effectuer un contrôle de cohérence sur le modèle du livre d’oeuvre avant de sauvegarder.Cela est appelé automatiquement par Workbook::Save Mais il peut être invocé indépendamment pendant le développement:

WorkbookValidator validator;
validator.ValidateForSave(workbook);

Conseils et meilleures pratiques

• Toujours les deux SetFormula1 et SetFormula2 Pour les évaluations de la gamme (WholeNumber, Decimal, DateDéfinir les limites inférieures et supérieurs.
• Utiliser SetIgnoreBlank(true) Pour permettre aux cellules vides de passer la validation sans déclencher un erreur.
• Appel à ValidationCollection::AreasOverlap avant d’ajouter une nouvelle règle pour vérifier les zones de validation sur la même feuille.
• WorkbookValidator::ValidateForSave est appelé à l’intérieur sur la sauvegarde; invite pendant le développement pour prendre les problèmes tôt.

Les problèmes communs

Le résumé de référence API

Voir aussi

• Aspose.Cells — Enterprise Documentation
• Aspose.Cells for C++ — Enterprise Documentation