メインコンテキスト

MainContextコンポーネントは、1つ以上のRecordContexts、SubGrids、またはManyToManyLookupEditorsをカプセル化し、それらすべてにわたる保存、更新、検証、ダーティステートの追跡を座標化するために使われます。

子コンポーネント

MainContextは以下の子コンポーネントのいずれかの組み合わせを含みます。

• RecordContext — 編集のために単一のDataverseレコードをラップします。
• SubGrid — 関連記録のコレクションを表示・管理します。
• ManyToManyLookupEditor — 多対多の関係を管理。

貯蓄

MenuBar内に変更を永続化できるSaveContextButtonを含めること。保存ボタンをクリックすると、すべての子コンポーネントにわたるすべてのダーティレコードがDataverseへの単一のトランザクションリクエストにまとめて保存されます。もしレコードが保存に失敗した場合、トランザクション全体がロールバックされ、変更は永続化されません。

さっぱりした

保存されていない変更を破棄し、Dataverseからレコードを再ロードできる RefreshContextButton を含めること。保存されていない変更がある場合は、リフレッシュが行われる前に確認ダイアログが表示されます。

検証

デフォルトでは、 MainContext は保存前にすべての子コンポーネントを検証します。 ForceSuccessfulValidationBeforeSave を false に設定してこの動作を無効にしてください。

ダーティステートトラッキング

MainContextは、IsDirtyプロパティを通じて、子コンポーネントに保存されていない変更があるかどうかを自動的に追跡します。保存されていない変更がある状態でユーザーがページから離れようとすると、確認ダイアログが表示されます。DisableUnsavedChangesWarningをtrueに設定して、ナビゲーション変更時にこのダイアログを抑制してください。この設定に関係なく、リフレッシュ時に常に警告が表示されます。

インターセプティングセーブ

OnBeforeSaveコールバックを使って、セーブ操作前にカスタムロジックを実行してください。セーブを進めないようにCancelEventArgs.Cancelをtrueに設定してください。