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