データ検証
データ検証の種類と実行
データ検証は、ワークシートに入力されたデータに関するルールを設定する機能です。たとえば、検証を使用して、DATE というラベルの付いた列に日付のみが含まれていること、または別の列に数値のみが含まれていることを確認します。 DATE というラベルの付いた列に、特定の範囲内の日付のみが含まれるようにすることもできます。データ検証を使用すると、ワークシートのセルに入力される内容を制御できます。
Microsoft Excel は、さまざまな種類のデータ検証をサポートしています。各タイプは、セルまたはセル範囲に入力されるデータのタイプを制御するために使用されます。以下のコード スニペットは、それを検証する方法を示しています。
- Numbers は整数です。つまり、小数部分がありません。
- 10 進数は正しい構造に従います。コード例では、セルの範囲に 2 つの小数点以下のスペースが必要であることを定義しています。
- 値は値のリストに制限されています。リストの検証では、セルまたはセル範囲に適用できる個別の値のリストを定義します。
- 日付は特定の範囲内にあります。
- 時間は特定の範囲内です。
- テキストは指定された文字長以内です。
Microsoft Excel によるデータ検証
Microsoft Excel を使用して検証を作成するには:
- ワークシートで、検証を適用するセルを選択します。
- からデータメニュー、選択検証.検証ダイアログが表示されます。
- クリック設定タブを開き、設定を入力します。
Aspose.Cells によるデータ検証
データ検証は、ワークシートに入力された情報を検証するための強力な機能です。データ検証を使用すると、開発者はユーザーに選択肢のリストを提供したり、データ エントリを特定のタイプやサイズに制限したりできます。 Aspose.Cellsで、それぞれワークシートクラスには検証のコレクションを表すプロパティ検証オブジェクト。検証を設定するには、いくつかの検証クラスのプロパティは次のとおりです。
- Type – 検証タイプを表します。これは、検証タイプ列挙。
- 演算子 – 検証で使用される演算子を表します。これは、OperatorType列挙。
- Formula1 – データ検証の最初の部分に関連付けられた値または式を表します。
- Formula2 – データ検証の 2 番目の部分に関連付けられた値または式を表します。
とき検証オブジェクトのプロパティが構成されているため、開発者はセルエリア作成された検証を使用して検証されるセル範囲に関する情報を格納する構造。
データ検証の種類
の検証タイプ列挙には次のメンバーがあります。
| メンバー名 | 説明 |
|---|---|
| AnyValue | 任意の型の値を示します。 |
| 整数 | 整数の検証タイプを示します。 |
| 小数 | 10 進数の検証タイプを示します。 |
| リスト | ドロップダウン リストの検証タイプを示します。 |
| 日にち | 日付の検証タイプを示します。 |
| 時間 | 時間の検証タイプを示します。 |
| テキストの長さ | テキストの長さの検証タイプを示します。 |
| カスタム | カスタム検証タイプを示します。 |
整数データの検証
このタイプの検証では、ユーザーは指定された範囲内の整数のみを検証済みのセルに入力できます。以下のコード例は、WholeNumber 検証タイプを実装する方法を示しています。この例では、上記の Microsoft Excel を使用して作成したものと同じデータ検証を Aspose.Cells を使用して作成します。
リスト データの検証
このタイプの検証では、ユーザーはドロップダウン リストから値を入力できます。データを含む一連の行であるリストを提供します。この例では、リスト ソースを保持するために 2 番目のワークシートが追加されます。ユーザーはリストからのみ値を選択できます。検証領域は、最初のワークシートのセル範囲 A1:A5 です。
ここで重要なのは、Validation.InCellDropDownプロパティへ真実.
日付データの検証
このタイプの検証では、ユーザーは指定された範囲内の日付値、または特定の基準を満たす日付値を検証済みセルに入力します。この例では、ユーザーは 1970 年から 1999 年までの日付を入力するように制限されています。ここでは、検証領域は B1 セルです。
時間データの検証
このタイプの検証では、ユーザーは、指定された範囲内の時間を入力するか、いくつかの条件を満たす時間を検証済みのセルに入力できます。この例では、ユーザーは午前 9 時から午前 11 時 30 分までの時間を入力するように制限されています。ここでは、検証領域は B1 セルです。
テキスト長データの検証
このタイプの検証では、ユーザーは指定された長さのテキスト値を検証済みのセルに入力できます。この例では、ユーザーは 5 文字以下の文字列値を入力するように制限されています。検証領域は B1 セルです。
データ検証規則
データ検証が実装されている場合、セルに異なる値を割り当てることで検証を確認できます。Cell.GetValidationValue検証結果を取得するために使用できます。次の例は、この機能をさまざまな値で示しています。サンプル ファイルは、テスト用に次のリンクからダウンロードできます。
sampleDataValidationRules.xlsx
セルの検証がドロップダウンかどうかを確認します
これまで見てきたように、セル内に実装できる検証には多くの種類があります。バリデーションがドロップダウンかどうかを確認したい場合は、Validation.InCellDropDownプロパティを使用してこれをテストできます。次のサンプル コードは、このプロパティの使用方法を示しています。テスト用のサンプル ファイルは、次のリンクからダウンロードできます。
CellArea を既存の Validation に追加
追加したくなるケースもあるかもしれませんセルエリア既存へ検証.追加するとセルエリア使用してValidation.AddArea(CellArea セルエリア)、Aspose.Cells は、すべての既存のエリアをチェックして、新しいエリアが既に存在するかどうかを確認します。ファイルに多数の検証がある場合、パフォーマンスが低下します。これを克服するために、API はValidation.AddAreaCellArea cellArea、bool checkIntersection、bool checkEdge)方法。のチェック交差点パラメータは、特定の領域と既存の検証領域との交差をチェックするかどうかを示します。に設定する間違い他の領域のチェックを無効にします。のチェックエッジパラメータは、適用された領域をチェックするかどうかを示します。新しい領域が左上の領域になると、内部設定が再構築されます。新しい領域が左上の領域でないことが確実な場合は、このパラメータを次のように設定できます。間違い.
次のコード スニペットは、Validation.AddAreaCellArea cellArea、bool checkIntersection、bool checkEdge)新規追加方法セルエリア既存へ検証.
参照用にソースと出力の Excel ファイルが添付されています。