グリッドウィジェット内での編集を有効にするには、次の手順を実行します。

ランタイムでグリッドを編集する方法を制御するには、ウィジェットの EditLevel プロパティを以下のいずれかのオプションに設定します。

検証が有効になっている列の編集を行うと同時に、入力したデータが有効であることを確認するために入力が評価されます。検証に失敗した場合、エラーメッセージが表示され、変更は保存されません。検証の詳細については、グリッド内の入力の検証を参照してください。

EditButton プロパティを IsEditable プロパティの代わりに有効にすることもできます。このプロパティを true に設定すると、グリッドツールバーに編集ボタンが追加されます。ランタイムでボタンをクリックすることにより、編集モードのオン/オフを切り替えることができます。

グリッド編集モードでは、複数のセルを更新してから「保存」ボタンをクリックすることで、すべての変更を同時に保存できます。

以下のイメージは、グリッド全体を編集するときに、ランタイムでウィジェットの左上領域に表示される編集ボタンを示しています。

「編集」をクリックすると、「保存」ボタンと「キャンセル」ボタンが表示されます。編集コントロールは、グリッド上で編集が有効になっているセルごとに表示されます。1 つ以上のセルのデータを編集し、「保存」をクリックして編集を保存できます。保存されていない編集が含まれているセルをハイライトするには、HighlightDraftState プロパティを True に設定します。編集されたセルは、異なる背景色を使用して示されます。

このモードでは、以下の編集イベントを使用できます。

行編集により、一度に 1 行ずつ編集できます。このモードを有効にすると、編集コントロールが含まれている列がグリッドの左側に追加されます。以下のイメージは、行編集モードに設定されているグリッドウィジェットを示しています。

行を編集するには、編集アイコンまたはリンクをクリックします。行内のセルが含まれている編集フォームが表示されます。値を編集した後、「更新」をクリックして、現在の行に対する変更を保存します。

このモードでは、以下の編集イベントを使用できます。

このモードでは、以下の編集イベントを使用できます。

セルの編集アイコンまたはリンクをクリックすることで、セルを編集できます。編集ボックスがアクティブであるとき、フォーマットのない生の値が表示されます。編集が終了すると、列レンダラーが適用されて値がフォーマットされます。レンダラーの詳細については、グリッドの列レンダラーとフォーマットを参照してください。

EditControlType プロパティを使用して、編集コントロールのアイコンまたはリンクを表示します。このアイコンは、EditControlIcon プロパティを使用して、サーバー上の任意のメディアエンティティに置き換えることができます。リンクのデフォルトの編集ラベルを変更するには、EditControlLabel プロパティを使用します。デフォルトでは、セルにポインタを合わせると編集コントロールが表示されます。EditControlVisibility プロパティを使用して、編集コントロールの表示を設定できます。

列の編集を有効にするには、次の JSON データを追加します。