データ検証
Microsoft Excel には、ワークシート データを自動フィルター処理または検証するための優れた機能がいくつか用意されています。
データ検証ワークシートに入力されたデータに関するルールを設定する機能です。たとえば、検証を使用して、DATE というラベルの付いた列に日付のみが含まれていること、または別の列に数値のみが含まれていることを確認します。 DATE というラベルの付いた列に、特定の範囲内の日付のみが含まれるようにすることもできます。データ検証を使用すると、ワークシートのセルに入力される内容を制御できます。 Aspose.Cells は、Microsoft Excel のデータ検証およびオートフィルター機能を完全にサポートします。この記事では、Microsoft Excel の機能の使用方法と、Aspose.Cells を使用してそれらをコーディングする方法について説明します。
データ検証の種類と実行
Microsoft Excel は、さまざまな種類のデータ検証をサポートしています。各タイプは、セルまたはセル範囲に入力されるデータのタイプを制御するために使用されます。以下のコード スニペットは、それを検証する方法を示しています。
- Numbers はまるごと、つまり、小数部分がありません。
- 10 進数は正しい構造に従います.コード例では、セルの範囲に 2 つの小数点以下のスペースが必要であることを定義しています。
- 値は値のリストに制限されています.リストの検証では、セルまたはセル範囲に適用できる個別の値のリストを定義します。
- 日付が特定の範囲内にある.
- 時間は特定の範囲内です.
- テキストは指定された文字長以内です.
Microsoft Excel によるデータ検証
Microsoft Excel を使用して検証を作成するには:
-
ワークシートで、検証を適用するセルを選択します。
-
からデータメニュー、選択検証. 検証ダイアログが表示されます。
-
クリック設定タブを開き、以下に示すように設定を入力します。
データ検証設定
Aspose.Cells によるデータ検証
データ検証は、ワークシートに入力された情報を検証するための強力な機能です。データ検証を使用すると、開発者はユーザーに選択肢のリストを提供したり、データ エントリを特定のタイプやサイズに制限したりできます。 Aspose.Cellsで、それぞれワークシートクラスには検証のコレクションを表すオブジェクト検証オブジェクト。検証を設定するには、いくつかの検証クラスのプロパティ:
- タイプ: 検証タイプを表します。これは、検証タイプ列挙。
- オペレーター検証で使用される演算子を表します。これは、OperatorType列挙。
- 式1: データ検証の最初の部分に関連付けられた値または式を表します。
- フォーミュラ2: データ検証の 2 番目の部分に関連付けられた値または式を表します。
とき検証オブジェクトのプロパティが構成されているため、開発者はセルエリア作成された検証を使用して検証されるセル範囲に関する情報を格納する構造。
データ検証の種類
データ検証を使用すると、各セルにビジネス ルールを組み込むことができるため、入力が正しくないとエラー メッセージが表示されます。ビジネス ルールは、ビジネスの運営方法を管理するポリシーと手順です。 Aspose.Cells は、重要な種類のデータ検証をすべてサポートしています。
の検証タイプ列挙には次のメンバーがあります。
メンバー名 | 説明 |
---|---|
ANY_VALUE | 任意の型の値を示します。 |
整数 | 整数の検証タイプを示します。 |
小数 | 10 進数の検証タイプを示します。 |
リスト | ドロップダウン リストの検証タイプを示します。 |
日にち | 日付の検証タイプを示します。 |
時間 | Time の検証タイプを示します。 |
TEXT_LENGTH | テキストの長さの検証タイプを示します。 |
習慣 | カスタム検証タイプを示します。 |
プログラミング サンプル: 整数データの検証
このタイプの検証では、ユーザーは指定された範囲内の整数のみを検証済みのセルに入力できます。以下のコード例は、整数検証タイプ。この例では、上記の Microsoft Excel を使用して作成したものと同じデータ検証を Aspose.Cells を使用して作成します。
プログラミング サンプル: 10 進数データの検証
このタイプの検証では、ユーザーは検証済みのセルに 10 進数を入力できます。この例では、ユーザーは 10 進数値のみを入力するように制限されており、検証領域は A1:A10 です。
プログラミング サンプル: リスト データの検証
このタイプの検証では、ユーザーはドロップダウン リストから値を入力できます。データを含む一連の行であるリストを提供します。ユーザーはリストからのみ値を選択できます。検証領域は、最初のワークシートのセル範囲 A1:A5 です。
ここで重要なのは、Validation.setInCellDropDownプロパティへ真実.
プログラミング サンプル: 日付データの検証
このタイプの検証では、ユーザーは指定された範囲内の日付値、または特定の基準を満たす日付値を検証済みセルに入力します。この例では、ユーザーは 1970 年から 1999 年までの日付を入力するように制限されています。ここでは、検証領域は B1 セルです。
プログラミング サンプル: 時間データの検証
このタイプの検証では、ユーザーは、指定された範囲内の時間を入力するか、いくつかの条件を満たす時間を検証済みのセルに入力できます。この例では、ユーザーは午前 9 時から午前 11 時 30 分までの時間を入力するように制限されています。ここでは、検証領域は B1 セルです。
プログラミング サンプル: テキスト長データの検証
このタイプの検証では、ユーザーは指定された長さのテキスト値を検証済みのセルに入力できます。この例では、ユーザーは 5 文字以下の文字列値を入力するように制限されています。検証領域は B1 セルです。
データ検証規則
データ検証が実装されている場合、セルに異なる値を割り当てることで検証を確認できます。Cell.GetValidationValue() を使用して検証結果を取得できます。次の例は、この機能をさまざまな値で示しています。サンプル ファイルは、テスト用に次のリンクからダウンロードできます。
SampleDataValidationRules.xlsx
サンプルコード
セル内の検証がドロップダウンかどうかを確認する
これまで見てきたように、セル内に実装できる検証には多くの種類があります。バリデーションがドロップダウンかどうかを確認したい場合は、Validation.InCellDropDownプロパティを使用してこれをテストできます。次のサンプル コードは、このプロパティの使用方法を示しています。テスト用のサンプル ファイルは、次のリンクからダウンロードできます。
sampleDataValidationRules.xlsx
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) 新規追加するメソッドセルエリア既存へ検証.
参照用にソースと出力の Excel ファイルが添付されています。