このトピックでは、定義済みのデータ検証ルールを構成および設定する方法について説明します。
以下の表は、このトピックを理解するための前提条件として必要な概念とトピックの一覧です。
XamSpreadsheet データ検証機能は、さまざまな制約の検証を実行し、ユーザー入力を許可または拒否するルール (ワークシートのセルに設定されている) に基づいています。ワークシートの各セルには、セルの DataValidationRule プロパティを使用して、検証ルールを 1 つのみ設定できます。
注:
コントロールがサポートする定義済みのデータ検証ルールのいくつかは、適切なルールをインスタンス化し、パラメーターを構成して、ワークシートのセルの DataValidationRule プロパティに設定するだけで、さまざまなデータ検証に使用できます。
以下の表では、定義済みのデータ検証ルール、その目的、および機能について簡単に説明しています。詳細は、表の後に記載されています。
このルールは検証を実行しませんが、セルをアクティブ化すると、入力メッセージを表示することができます。
以下の表は、任意の構成とそれを管理するプロパティ設定のマッピングを示します。
以下のコードは、AnyValueDataValidationRule を作成し入力メッセージに構成する方法、およびルールを "XamSpreadsheet1" という名前の XamSpreadsheet のセルに設定する方法を示します。
Visual Basic の場合:
Dim rule As New AnyValueDataValidationRule() rule.InputMessageTitle = "Experience" rule.InputMessageDescription = "Please list the frameworks your have experience with in this box" Me.XamSpreadsheet1.Workbook.Worksheet s (0).Rows(20).Cells(3).DataValidationRule = rule
C# の場合:
AnyValueDataValidationRule rule = new AnyValueDataValidationRule(); rule.InputMessageTitle = "Experience"; rule.InputMessageDescription = "Please list the frameworks your have experience with in this box"; this.XamSpreadsheet1.Workbook.Worksheet s [0].Rows[20].Cells[3].DataValidationRule = rule;
このルールは、単一の制約値に基づきユーザーの入力を検証します。たとえば、入力値は以下のようになります。
5 より大きい
7.35 の倍以下
2 日の時間範囲と等しい
日付が 2015 年 4 月 15 日と等しくない
以下の表は、任意の構成とそれを管理するプロパティ / メソッドの設定のマッピングを示します。
以下のコードは、OneConstrantDataValidationRule を作成し 5 以上の値を許可する検証ルールを構成する方法、およびルールを "XamSpreadsheet1" という名前の XamSpreadsheet のセルに設定する方法を示します。
Visual Basic の場合:
Dim rule As New OneConstraintDataValidationRule() rule.ValidationOperator = OneConstraintDataValidationOperator.GreaterThan rule.SetConstraint(5) Me.XamSpreadsheet1.Workbook.Worksheets(0).Rows(20).Cells(3).DataValidationRule = rule
C# の場合:
OneConstraintDataValidationRule rule = new OneConstraintDataValidationRule(); rule.ValidationOperator = OneConstraintDataValidationOperator.GreaterThan; rule.SetConstraint(5); this.XamSpreadsheet1.Workbook.Worksheets[0].Rows[20].Cells[3].DataValidationRule = rule;
このルールは、2 つの制約値に基づきユーザーの入力を検証します。たとえば、入力値は以下のようになります。
テキストの長さは 10 文字以上 15 文字以下
日付が 2015 年 6 月 16 日から 2015 年 7 月 10 日の間ではない
以下の表は、任意の構成とそれを管理するプロパティ / メソッドの設定のマッピングを示します。
以下のコードは、TwoConstrantDataValidationRule を作成しテキストの長さが 10 ～ 15 文字の範囲の値を許可する検証ルールを構成する方法、およびルールを "XamSpreadsheet1" という名前の XamSpreadsheet のセルに設定する方法を示します。
Visual Basic の場合:
Dim rule As New TwoConstraintDataValidationRule() rule.ValidationOperator = TwoConstraintDataValidationOperator.Between rule.ValidationCriteria = DataValidationCriteria.TextLength rule.SetLowerConstraint(10) rule.SetUpperConstraint(15) Me.XamSpreadsheet1.Workbook.Worksheets(0).Rows(20).Cells(3).DataValidationRule = rule
C# の場合:
TwoConstraintDataValidationRule rule = new TwoConstraintDataValidationRule(); rule.ValidationOperator = TwoConstraintDataValidationOperator.Between; rule.ValidationCriteria = DataValidationCriteria.TextLength; rule.SetLowerConstraint(10); rule.SetUpperConstraint(15); this.XamSpreadsheet1.Workbook.Worksheets[0].Rows[20].Cells[3].DataValidationRule = rule;
このルールは、承認済みの値のリストに基づき、ユーザーの入力を検証します。たとえば、1、2、4、8、16、32、64 および 128 のいずれかの値が入力されている必要があります。
以下の表は、任意の構成とそれを管理するメソッド設定のマッピングを示します。
以下のコードは、ListDataValidationRule を作成し値 1、2、4、8、16、32、64、および 128 を許可する検証ルールを構成する方法、およびルールを "XamSpreadsheet1" という名前の XamSpreadsheet のセルに設定する方法を示します。
Visual Basic の場合:
Dim rule As New ListDataValidationRule()
rule.SetValues(New Object() {1, 2, 4, 8, 16, 32, 64, 128})
Me.XamSpreadsheet1.Workbook.Worksheets(0).Rows(20).Cells(3).DataValidationRule = rule
C# の場合:
ListDataValidationRule rule = new ListDataValidationRule();
rule.SetValues(new object[] {1, 2, 4, 8, 16, 32, 64, 128});
this.XamSpreadsheet1.Workbook.Worksheets[0].Rows[20].Cells[3].DataValidationRule = rule;
このルールを使用すると、新しいセルの値の承認、または拒否に基づきブール値の結果を返す数式を設定できます。新しい値を承認するには、数式が True（"True" は大文字と小文字が区別されない)、null、またはゼロ以外の数値と評価されることが必要です。新しい値を拒否するには、数式が False、0、任意の ErrorValue (#VALUE! など)、または "True" (大文字と小文字が区別されない) 以外の文字列と評価されることが必要です。
数式に相対アドレスが使用された場合、2 番目の引数として基本参照アドレスを設定できます。基本参照アドレスが設定されていない場合は、左上が使用されます。
以下の表は、任意の構成とそれを管理するメソッド設定のマッピングを示します。
以下のコードは、CustomDataValidationRule を作成し、ワークシート内の特定のセル (この例では A2) に 2 以上の値がある場合に値を承認済みにする検証ルールの数式を構成する方法、およびルールを "XamSpreadsheet1" という名前の XamSpreadsheet のセルに設定する方法を示します。
Visual Basic の場合:
Dim rule As New CustomDataValidationRule()
rule.SetFormula("=IF(A2>2,TRUE,FALSE)", Nothing)
Me.XamSpreadsheet1.Workbook.Worksheet s (0).Rows(3).Cells(3).DataValidationRule = rule
C# の場合:
CustomDataValidationRule rule = new CustomDataValidationRule();
rule.SetFormula("=IF(A2>2,TRUE,FALSE)", null);
this.XamSpreadsheet1.Workbook.Worksheet s [0].Rows[3].Cells[3].DataValidationRule = rule;
以下のトピックでは、このトピックに関連する追加情報を提供しています。