Работа с проверкой данных

Работа с проверкой данных

Aspose.Cells FOSS for C++ supports adding cell-level data validation rules to worksheets via the Validation и в том числе: ValidationCollection Классы. WorkbookValidator класс обеспечивает проверку согласованности до сохранения.

Добавление правила проверки

Доступ к сборнику подтверждений для рабочего листа и добавление нового правила при помощи: ValidationCollection::Add(). Установление типа, формулы и целевой области на возвращенной Validation объект:

#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;
}

Типы проверки

В связи с этим ValidationType перечисление определяет виды ограничений, которые могут быть применены:

Стиль оповещения

В связи с этим ValidationAlertType перечисление контролирует поведение, показываемое при неудаче валидации:

Установка стиля оповещения с помощью: Validation::SetAlertStyle(ValidationAlertType).

Запрос подтверждения в ячейке

Использование: ValidationCollection::GetValidationInCell(row, col) чтобы найти, какое правило проверки применяется к конкретной ячейке. Возвращает nullptr если не применяется никакое правило.

Удаление правил проверки достоверности

Удаление подтверждения из конкретной ячейки или зоны диапазона:

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

Подтверждение рабочей книги до сохранения

Call WorkbookValidator::ValidateForSave чтобы запустить проверку согласованности на модели рабочей книги перед сохранением. Это автоматически вызвано Workbook::Save но могут быть использованы самостоятельно во время разработки:

WorkbookValidator validator;
validator.ValidateForSave(workbook);

Советы и лучшие практики

• Всегда настраивай оба . SetFormula1 и в том числе: SetFormula2 для проверки типа диапазона (WholeNumber, Decimal, Date) для определения нижней и верхней границ.
• Использование: SetIgnoreBlank(true) позволить пустым ячейкам пройти проверку без возникновения ошибки.
• Call ValidationCollection::AreasOverlap до добавления нового правила для проверки на наличие перекрытий областей валидации в одном и том же листе.
• WorkbookValidator::ValidateForSave Внутренне вызывается при сохранении; вызвать его во время разработки, чтобы зафиксировать проблемы на ранней стадии.

Общие проблемы

Справочное резюме API

See Also

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