データ検証

Microsoft Excel には、ワークシート データを自動フィルター処理または検証するための優れた機能がいくつか用意されています。

データ検証ワークシートに入力されたデータに関するルールを設定する機能です。たとえば、検証を使用して、DATE というラベルの付いた列に日付のみが含まれていること、または別の列に数値のみが含まれていることを確認します。 DATE というラベルの付いた列に、特定の範囲内の日付のみが含まれるようにすることもできます。データ検証を使用すると、ワークシートのセルに入力される内容を制御できます。 Aspose.Cells は、Microsoft Excel のデータ検証およびオートフィルター機能を完全にサポートします。この記事では、Microsoft Excel の機能の使用方法と、Aspose.Cells を使用してそれらをコーディングする方法について説明します。

データ検証の種類と実行

Microsoft Excel は、さまざまな種類のデータ検証をサポートしています。各タイプは、セルまたはセル範囲に入力されるデータのタイプを制御するために使用されます。以下のコード スニペットは、それを検証する方法を示しています。

• Numbers はまるごと、つまり、小数部分がありません。
• 10 進数は正しい構造に従います.コード例では、セルの範囲に 2 つの小数点以下のスペースが必要であることを定義しています。
• 値は値のリストに制限されています.リストの検証では、セルまたはセル範囲に適用できる個別の値のリストを定義します。
• 日付が特定の範囲内にある.
• 時間は特定の範囲内です.
• テキストは指定された文字長以内です.

Microsoft Excel によるデータ検証

Microsoft Excel を使用して検証を作成するには:

1. ワークシートで、検証を適用するセルを選択します。

2. からデータメニュー、選択検証. 検証ダイアログが表示されます。

3. クリック設定タブを開き、以下に示すように設定を入力します。

   データ検証設定

Aspose.Cells によるデータ検証

データ検証は、ワークシートに入力された情報を検証するための強力な機能です。データ検証を使用すると、開発者はユーザーに選択肢のリストを提供したり、データ エントリを特定のタイプやサイズに制限したりできます。 Aspose.Cellsで、それぞれワークシートクラスには検証のコレクションを表すオブジェクト検証オブジェクト。検証を設定するには、いくつかの検証クラスのプロパティ:

• タイプ: 検証タイプを表します。これは、検証タイプ列挙。
• オペレーター検証で使用される演算子を表します。これは、OperatorType列挙。
• 式1: データ検証の最初の部分に関連付けられた値または式を表します。
• フォーミュラ2: データ検証の 2 番目の部分に関連付けられた値または式を表します。

とき検証オブジェクトのプロパティが構成されているため、開発者はセルエリア作成された検証を使用して検証されるセル範囲に関する情報を格納する構造。

データ検証の種類

データ検証を使用すると、各セルにビジネス ルールを組み込むことができるため、入力が正しくないとエラー メッセージが表示されます。ビジネス ルールは、ビジネスの運営方法を管理するポリシーと手順です。 Aspose.Cells は、重要な種類のデータ検証をすべてサポートしています。

の検証タイプ列挙には次のメンバーがあります。

メンバー名	説明
ANY_VALUE	任意の型の値を示します。
整数	整数の検証タイプを示します。
小数	10 進数の検証タイプを示します。
リスト	ドロップダウン リストの検証タイプを示します。
日にち	日付の検証タイプを示します。
時間	Time の検証タイプを示します。
TEXT_LENGTH	テキストの長さの検証タイプを示します。
習慣	カスタム検証タイプを示します。

プログラミング サンプル: 整数データの検証

このタイプの検証では、ユーザーは指定された範囲内の整数のみを検証済みのセルに入力できます。以下のコード例は、整数検証タイプ。この例では、上記の Microsoft Excel を使用して作成したものと同じデータ検証を Aspose.Cells を使用して作成します。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(WholeNumberDataValidation.class) + "data/";

// Instantiating an Workbook object
Workbook workbook = new Workbook();
WorksheetCollection worksheets = workbook.getWorksheets();

// Accessing the Validations collection of the worksheet
Worksheet worksheet = worksheets.get(0);

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

ValidationCollection validations = worksheet.getValidations();

// Creating a Validation object
int index = validations.add(area);
Validation validation = validations.get(index);

// Setting the validation type to whole number
validation.setType(ValidationType.WHOLE_NUMBER);

// Setting the operator for validation to Between
validation.setOperator(OperatorType.BETWEEN);

// Setting the minimum value for the validation
validation.setFormula1("10");

// Setting the maximum value for the validation
validation.setFormula2("1000");

// Saving the Excel file
workbook.save(dataDir + "WNDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

プログラミング サンプル: 10 進数データの検証

このタイプの検証では、ユーザーは検証済みのセルに 10 進数を入力できます。この例では、ユーザーは 10 進数値のみを入力するように制限されており、検証領域は A1:A10 です。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(DecimalDataValidation.class) + "data/";

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

// Create a worksheet and get the first worksheet.
Worksheet ExcelWorkSheet = workbook.getWorksheets().get(0);

// Specify the validation area of cells.
CellArea area = new CellArea();
area.StartRow = 0;
area.StartColumn = 0;
area.EndRow = 9;
area.EndColumn = 0;

// Obtain the existing Validations collection.
ValidationCollection validations = ExcelWorkSheet.getValidations();

// Create a validation object adding to the collection list.
int index = validations.add(area);
Validation validation = validations.get(index);

// Set the validation type.
validation.setType(ValidationType.DECIMAL);

// Specify the operator.
validation.setOperator(OperatorType.BETWEEN);

// Set the lower and upper limits.
validation.setFormula1("10");
validation.setFormula2("1000");

// Set the error message.
validation.setErrorMessage("Please enter a valid integer or decimal number");

// Save the workbook.
workbook.save(dataDir + "DDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

プログラミング サンプル: リスト データの検証

このタイプの検証では、ユーザーはドロップダウン リストから値を入力できます。データを含む一連の行であるリストを提供します。ユーザーはリストからのみ値を選択できます。検証領域は、最初のワークシートのセル範囲 A1:A5 です。

ここで重要なのは、Validation.setInCellDropDownプロパティへ真実.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(ListDataValidation.class) + "data/";

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

// Get the first worksheet.
Worksheet ExcelWorkSheet = workbook.getWorksheets().get(0);

// Add a new worksheet and access it.
int sheetIndex = workbook.getWorksheets().add();
Worksheet worksheet2 = workbook.getWorksheets().get(sheetIndex);

// Create a range with name in the second worksheet.
Range range = worksheet2.getCells().createRange(0, 4, 4, 4);
range.setName("MyRange");

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

// Specify the validation area of cells.
CellArea area = new CellArea();
area.StartRow = 0;
area.StartColumn = 0;
area.EndRow = 4;
area.EndColumn = 0;

// Obtain the existing Validations collection.
ValidationCollection validations = ExcelWorkSheet.getValidations();

// Create a validation object adding to the collection list.
int index = validations.add(area);
Validation validation = validations.get(index);

// Set the validation type.
validation.setType(ValidationType.LIST);

// Set the in cell drop down.
validation.setInCellDropDown(true);

// Set the formula1.
validation.setFormula1("=MyRange");

// Enable it to show error.
validation.setShowError(true);

// Set the alert type severity level.
validation.setAlertStyle(ValidationAlertType.STOP);

// Set the error title.
validation.setErrorTitle("Error");

// Set the error message.
validation.setErrorMessage("Please select a color from the list");

// Save the excel file.
workbook.save(dataDir + "LDValidation_out.xls");

// Print message
System.out.println("Process completed successfully");

プログラミング サンプル: 日付データの検証

このタイプの検証では、ユーザーは指定された範囲内の日付値、または特定の基準を満たす日付値を検証済みセルに入力します。この例では、ユーザーは 1970 年から 1999 年までの日付を入力するように制限されています。ここでは、検証領域は B1 セルです。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(DateDataValidation.class) + "data/";

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

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

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

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

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

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.DATE);

// Set the operator for the data validation
validation.setOperator(OperatorType.BETWEEN);

// Set the value or expression associated with the data validation.
validation.setFormula1("1/1/1970");

// The value or expression associated with the second part of the data
// validation.
validation.setFormula2("12/31/1999");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.STOP);

// Set the title of the data-validation error dialog box
validation.setErrorTitle("Date Error");

// Set the data validation error message.
validation.setErrorMessage("Enter a Valid Date");

// Set and enable the data validation input message.
validation.setInputMessage("Date Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "DDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

プログラミング サンプル: 時間データの検証

このタイプの検証では、ユーザーは、指定された範囲内の時間を入力するか、いくつかの条件を満たす時間を検証済みのセルに入力できます。この例では、ユーザーは午前 9 時から午前 11 時 30 分までの時間を入力するように制限されています。ここでは、検証領域は B1 セルです。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(TimeDataValidation.class) + "data/";

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

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

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

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

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

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.TIME);

// Set the operator for the data validation
validation.setOperator(OperatorType.BETWEEN);

// Set the value or expression associated with the data validation.
validation.setFormula1("09:00");

// The value or expression associated with the second part of the data
// validation.
validation.setFormula2("11:30");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.INFORMATION);

// Set the title of the data-validation error dialog box.
validation.setErrorTitle("Time Error");

// Set the data validation error message.
validation.setErrorMessage("Enter a Valid Time");

// Set and enable the data validation input message.
validation.setInputMessage("Time Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "TDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

プログラミング サンプル: テキスト長データの検証

このタイプの検証では、ユーザーは指定された長さのテキスト値を検証済みのセルに入力できます。この例では、ユーザーは 5 文字以下の文字列値を入力するように制限されています。検証領域は B1 セルです。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the documents directory.
String dataDir = Utils.getSharedDataDir(TextLengthDataValidation.class) + "data/";

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

// Obtain the cells of the first worksheet.
Cells cells = workbook.getWorksheets().get(0).getCells();

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

// Wrap the text.
Style style = cells.get("A1").getStyle();
style.setTextWrapped(true);
cells.get("A1").setStyle(style);

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

// Set a collection of CellArea which contains the data validation
// settings.
CellArea area = new CellArea();

area.StartRow = 0;
area.StartColumn = 1;
area.EndRow = 0;
area.EndColumn = 1;

// Get the validations collection.
ValidationCollection validations = workbook.getWorksheets().get(0).getValidations();

// Add a new validation.
int i = validations.add(area);
Validation validation = validations.get(i);

// Set the data validation type.
validation.setType(ValidationType.TEXT_LENGTH);

// Set the operator for the data validation.
validation.setOperator(OperatorType.LESS_OR_EQUAL);

// Set the value or expression associated with the data validation.
validation.setFormula1("5");

// Enable the error.
validation.setShowError(true);

// Set the validation alert style.
validation.setAlertStyle(ValidationAlertType.WARNING);

// Set the title of the data-validation error dialog box.
validation.setErrorTitle("Text Length Error");

// Set the data validation error message.
validation.setErrorMessage(" Enter a Valid String");

// Set and enable the data validation input message.
validation.setInputMessage("TextLength Validation Type");
validation.setIgnoreBlank(true);
validation.setShowInput(true);

// Save the excel file.
workbook.save(dataDir + "TLDValidation_out.xls", FileFormatType.EXCEL_97_TO_2003);

// Print message
System.out.println("Process completed successfully");

データ検証規則

データ検証が実装されている場合、セルに異なる値を割り当てることで検証を確認できます。Cell.GetValidationValue() を使用して検証結果を取得できます。次の例は、この機能をさまざまな値で示しています。サンプル ファイルは、テスト用に次のリンクからダウンロードできます。

SampleDataValidationRules.xlsx

サンプルコード

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// Instantiate the workbook from sample Excel file
Workbook workbook = new Workbook(srcDir + "sampleDataValidationRules.xlsx");

// Access the first worksheet
Worksheet worksheet = workbook.getWorksheets().get(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.getCells().get("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
System.out.println("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
System.out.println("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
System.out.println("Is 30 a Valid Value for this Cell: " + cell.getValidationValue());

// Enter large number 12345678901 inside this cell
// Since it is not between 1 and 999999999999, it should pass the validation again
Cell cell2 = worksheet.getCells().get("D1");
cell2.putValue(12345678901l);

// Check if number 12345678901 satisfies the Data Validation rule applied on this cell
System.out.println("Is 12345678901 a Valid Value for this Cell: " + cell2.getValidationValue());

セル内の検証がドロップダウンかどうかを確認する

これまで見てきたように、セル内に実装できる検証には多くの種類があります。バリデーションがドロップダウンかどうかを確認したい場合は、Validation.InCellDropDownプロパティを使用してこれをテストできます。次のサンプル コードは、このプロパティの使用方法を示しています。テスト用のサンプル ファイルは、次のリンクからダウンロードできます。

sampleDataValidationRules.xlsx

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
Workbook book = new Workbook(srcDir + "sampleValidation.xlsx");
Worksheet sheet = book.getWorksheets().get("Sheet1");
Cells cells  = sheet.getCells();
Cell a2 = cells.get("A2");
Validation va2 = a2.getValidation();
if(va2.getInCellDropDown()) {
    System.out.println("A2 is a dropdown");
} else {
    System.out.println("A2 is NOT a dropdown");
}
Cell b2 = cells.get("B2");
Validation vb2 = b2.getValidation();
if(vb2.getInCellDropDown()) {
    System.out.println("B2 is a dropdown");
} else {
    System.out.println("B2 is NOT a dropdown");
}
Cell c2 = cells.get("C2");
Validation vc2 = c2.getValidation();
if(vc2.getInCellDropDown()) {
    System.out.println("C2 is a dropdown");
} else {
    System.out.println("C2 is NOT a dropdown");
}

CellArea を既存の Validation に追加

追加したくなるケースもあるかもしれませんセルエリア既存へ検証.追加するとセルエリア使用してValidation.AddArea(CellArea セルエリア)、Aspose.Cells は、既存のすべてのエリアをチェックして、新しいエリアが既に存在するかどうかを確認します。ファイルに多数の検証がある場合、パフォーマンスが低下します。これを克服するために、API は[Validation.AddAreaCellArea cellArea、bool checkIntersection、bool checkEdge)](https://reference.aspose.com/cells/java/com.aspose.cells/Validation#addArea(com.aspose.cells.CellArea,%20boolean,%20boolean)） 方法。のチェック交差点パラメータは、特定の領域と既存の検証領域との交差をチェックするかどうかを示します。に設定する間違い他の領域のチェックを無効にします。のチェックエッジパラメータは、適用された領域をチェックするかどうかを示します。新しい領域が左上の領域になると、内部設定が再構築されます。新しい領域が左上の領域でないことが確実な場合は、このパラメータを次のように設定できます。間違い.

次のコード スニペットは、Validation.AddAreaCellArea cellArea、bool checkIntersection、bool checkEdge) 新規追加するメソッドセルエリア既存へ検証.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-Java
// The path to the directories.
String sourceDir = Utils.Get_SourceDirectory();
String outputDir = Utils.Get_OutputDirectory();

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

// Access first worksheet.
Worksheet worksheet = workbook.getWorksheets().get(0);

// Accessing the Validations collection of the worksheet
Validation validation = worksheet.getValidations().get(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");

参照用にソースと出力の Excel ファイルが添付されています。

ソースファイル

出力ファイル

先行トピック

• ODS ファイルで Cell 検証を取得する
• Cell に検証を適用する
• Cell 値がデータ検証ルールを満たしていることを確認する