データ検証

Microsoft Excel には、ワークシートのデータを自動フィルター処理または検証するための優れた機能がいくつか用意されています。この記事では、Microsoft Excel の機能を使用する方法と、Aspose.Cells を使用してそれらをコーディングする方法について説明します。

データ検証の種類と実行

データ検証は、ワークシートに入力されたデータに関するルールを設定する機能です。たとえば、検証を使用して、DATE というラベルの付いた列に日付のみが含まれていること、または別の列に数値のみが含まれていることを確認します。 DATE というラベルの付いた列に、特定の範囲内の日付のみが含まれるようにすることもできます。データ検証を使用すると、ワークシートのセルに入力される内容を制御できます。

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

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

Microsoft Excel によるデータ検証

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

1. ワークシートで、検証を適用するセルを選択します。
2. からデータメニュー、選択検証.検証ダイアログが表示されます。
3. クリック設定タブを開き、設定を入力します。

Aspose.Cells によるデータ検証

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

• Type – 検証タイプを表します。これは、検証タイプ列挙。
• 演算子 – 検証で使用される演算子を表します。これは、OperatorType列挙。
• Formula1 – データ検証の最初の部分に関連付けられた値または式を表します。
• Formula2 – データ検証の 2 番目の部分に関連付けられた値または式を表します。

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

データ検証の種類

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

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

整数データの検証

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

// 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");

リスト データの検証

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

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

// 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");

日付データの検証

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

時間データの検証

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

テキスト長データの検証

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

データ検証規則

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

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());

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

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

サンプル検証.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");
}

CellArea を既存の Validation に追加

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

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

// 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");

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

ソースファイル

出力ファイル

先行トピック

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