バージョン

データ検証の概要

トピックの概要

目的

このトピックでは、検証機能を使用する方法について説明します。

前提条件

本トピックの理解を深めるために、以下のトピックを参照することをお勧めします。

トピック 目的

このトピックは、xamDataGrid コントロールの概要を提供し、要素のダイアグラムを含みます。

このトピックの内容

このトピックは、以下のセクションで構成されます。

概要

概要

データ項目が .NET Framework にある INotifyDataErrorInfo または IDataErrorInfo インターフェイスを実装する場合、ユーザーがセルに無効なデータを入力すると DataPresenter のコントロール ファミリーはエラー メッセージを表示できます。ただし、 FieldLayoutSettings オブジェクトの SupportDataErrorInfo プロパティを SupportDataErrorInfo 列挙値に設定すると、 データ エラー情報のサポートを有効にする必要があります。

データ エラー サポート有効化に加えて、SupportDataErrorInfo プロパティは DataPresenter コントロールがセル、レコード セレクターまたは両方のいずれにデータ エラーを表示するかを決定します。

以下の画像は最初のレコードの ProductID 列でデータ エラーを表示します。

xamDataPresenter About Data Validation 01.png

注:

Note

データ項目で両方のインターフェイスが実装される場合、INotifyDataErrorInfo インターフェイスは IDataErrorInfo インターフェイスより優先されます。INotifyDataErrorInfo インターフェイスを利用する利点は、レコードまたはセルにエラー メッセージが 2 つ以上使用できることです。

データ エラー サポートの構成

以下の表では、SupportDataErrorInfo プロパティの値に基づいてエラー情報を取得するために DataPresenter コントロールがデータ項目のメソッドまたはプロパティをアクセスする方法を表示します。

SupportDataErrorInfo プロパティに設定される値2 IDataErrorInfo インターフェイス INotifyDataErrorInfo インターフェイス

RecordsOnly

Error プロパティをクエリすると、レコードのエラー メッセージを取得します。

GetErrors() メソッドを空の文字列を引数値として渡してクエリすると、レコードのエラー メッセージを取得します。

CellsOnly

データ項目のインデクサーをプロパティ名を引数として渡してクエリすると、各プロパティ エラー メッセージを取得します。

GetErrors() メソッドをプロパティ名を引数値として渡してクエリすると、各プロパティ エラー メッセージを取得します。

RecordsAndCells

以上の両方。

以上の両方。

FieldLayoutSettings オブジェクトでデータ エラー サポートを有効にする場合、影響を受けたフィールド レイアウトのフィールドはデータ エラーを自動的にレポートします。フィールド オブジェクトの FieldSettings プロパティによって公開されている SupportDataErrorInfo プロパティを false に設定することによってフィールドでこの機能を選択的に無効にできます。

FieldLayoutSettings オブジェクトの DataErrorDisplayMode プロパティを DataErrorDisplayMode 列挙値に設定することによって、 DataPresenter コントロールがデータ エラーをレポートする方法を修正することも可能です。DataErrorDisplayMode プロパティを設定すると、データ エラーがエラー アイコン、強調表示または両方のいずれで示されるかを決定します。

エディターの値制約

IDataErrorInfo インターフェイスまたは INotifyDataErrorInfo インターフェイスのサポートを有効にして、組み込まれた xamEditor コントロールの ValueConstraint プロパティを設定する場合、値の制約エラーが原因となってエラー アイコンと強調表示の両方またはいずれかが表示されます。値の制約によりエンドユーザーにエラーを修正することを強制し、修正するまでフォーカスを新しいセルに移動できません。FieldSettings オブジェクトの InvalidValueBehavior プロパティを RevertValue に設定する場合、セルの値は自動的に元の値に戻ります。これによってエンドユーザーはフォーカスを新しいセルに移動できます。ただし、値は値の制約を常に渡すため、 DataPresenter コントロールはエラー アイコン/強調表示を表示することはありません。一方、値の制約を使用しない場合、 DataPresenter コントロールはデータ項目のエラー メッセージを適切なセルに表示し、エンドユーザーはフォーカスを新しいセルに移動できます。

関連コンテンツ

トピック

このトピックの追加情報については、以下のトピックも合わせてご参照ください。

トピック 目的

このトピックでは、データ エラー サポートを有効にする方法を説明し、コード例を提供します。

このトピックでは、ユーザーがセル値を編集するときに検証フィードバックを表示する方法を説明します。

このトピックでは、視覚データ検証インジケーターのカスタム スタイルを設定する方法を紹介します。

このトピックでは、カスタム検証ロジックを定義する方法について説明します。