DataGridView.DefaultValuesNeeded イベント

.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

C#

public event DataGridViewRowEventHandler DefaultValuesNeeded

C++

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

J#

/** @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

C#

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();
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
DataGridView クラス
DataGridView メンバ
System.Windows.Forms 名前空間
その他の技術情報
DataGridView コントロール (Windows フォーム)