DataGridView.DefaultValuesNeeded イベント

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

行が既定値を伴って作成されるように、ユーザーが新しいレコードに対して行を挿入したときに発生します。

public:
 event System::Windows::Forms::DataGridViewRowEventHandler ^ DefaultValuesNeeded;

public event System.Windows.Forms.DataGridViewRowEventHandler DefaultValuesNeeded;

member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler 

Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler 

イベントの種類

DataGridViewRowEventHandler

例

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

この例を実行するには、列名を実際 DataGridView のコントロールの列オブジェクトの名前に置き換え、適切な既定値を指定します。 列を名前で指定する場合は、列ヘッダー テキストではなく、列オブジェクトの名前を使用する必要があります。

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["Country"].Value = "USA";
    e.Row.Cells["CustomerID"].Value = NewCustomerId();
}

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("Country").Value = "USA"
        .Cells("CustomerID").Value = NewCustomerId()
    End With

End Sub

注釈

このイベントを使用すると、ユーザーが行を入力したときに、新しいレコードの行を設定できます。 行の初期値は、各列CellTemplateの DefaultNewRowValue プロパティによって返される の DataGridViewCell プロパティから取得されます。

データ バインド モードでは、データ バインド列のすべてのセル値が外部データ ソースに格納されます。 ユーザーが新しいレコードの行を入力すると、イベントが発生する前にデータ ソースに新しい行が DefaultValuesNeeded 作成されます。 イベント ハンドラーで プロパティを DataGridViewRowEventArgs.Row 設定すると、値がデータ ソースに直接追加されます。

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

イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。

こちらもご覧ください

• DataGridView コントロール (Windows フォーム)