DataGridView.DefaultValuesNeeded イベントとは何？わかりやすく解説 Weblio辞書

.NET Framework クラスライブラリリファレンス

索引トップ用語の索引ランキング

DataGridView.DefaultValuesNeeded イベント

メモ : このイベントは、.NET Framework version 2.0 で新しく追加されたものです。

ユーザーが新しいレコードの行を入力して、その行に既定値を読み込むことができる場合に発生します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Event DefaultValuesNeeded As
 DataGridViewRowEventHandler

Visual Basic (使用法)

Dim instance As DataGridView
Dim handler As DataGridViewRowEventHandler

AddHandler instance.DefaultValuesNeeded, handler

public event DataGridViewRowEventHandler DefaultValuesNeeded

C++

public:
event DataGridViewRowEventHandler^ DefaultValuesNeeded {
    void add (DataGridViewRowEventHandler^ value);
    void remove (DataGridViewRowEventHandler^ value);
}

/** @event */
public void add_DefaultValuesNeeded (DataGridViewRowEventHandler
 value)

/** @event */
public void remove_DefaultValuesNeeded (DataGridViewRowEventHandler
 value)

JScript

JScript では、イベントは使用できますが、新規に宣言することはできません。

解説

このイベントは、ユーザーが行に入力した場合にだけ新しいレコードの行を作成します。この行の初期値は、各列の CellTemplate プロパティによって返される DataGridViewCell の DefaultNewRowValue プロパティから取得されます。

仮想モードでは、このイベントが発生した後、データストアに既定値を格納できるように、新しい行のセルごとに CellValuePushed イベントが発生します。次に、新しい行のセルごとに CellValueNeeded イベントが発生し、CellValuePushed イベントに格納された値が取得され、表示されます。

イベント処理の詳細については、「イベントの利用」を参照してください。

使用例

このイベントの処理方法を示すコード例を次に示します。この例では、特定の列のセルに既定値が読み込まれます。CustomerID 列の場合、一意の顧客 ID を生成する (実装されていない) 個別のメソッドから値が取得されます。

この例を実行するには、列名を実際の DataGridView コントロールの列に置換して、適切な既定値を指定します。

Visual Basic

Private Sub dataGridView1_DefaultValuesNeeded(ByVal
 sender As Object, _
    ByVal e As System.Windows.Forms.DataGridViewRowEventArgs)
 _
    Handles dataGridView1.DefaultValuesNeeded

    With e.Row
        .Cells("Region").Value = "WA"
        .Cells("City").Value = "Redmond"
        .Cells("PostalCode").Value = "98052-6399"
        .Cells("Region").Value = "NA"
        .Cells("Country").Value = "USA"
        .Cells("CustomerID").Value = NewCustomerId()
    End With

End Sub

private void dataGridView1_DefaultValuesNeeded(object
 sender,
    System.Windows.Forms.DataGridViewRowEventArgs e)
{
    e.Row.Cells["Region"].Value = "WA";
    e.Row.Cells["City"].Value = "Redmond";
    e.Row.Cells["PostalCode"].Value = "98052-6399";
    e.Row.Cells["Region"].Value = "NA";
    e.Row.Cells["Country"].Value = "USA";
    e.Row.Cells["CustomerID"].Value = NewCustomerId();
}