DataGridView.DefaultValuesNeeded イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
行が既定値を伴って作成されるように、ユーザーが新しいレコードに対して行を挿入したときに発生します。
public:
event System::Windows::Forms::DataGridViewRowEventHandler ^ DefaultValuesNeeded;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 イベントの種類
例
次のコード例は、このイベントを処理する方法を示しています。 この例では、指定された列のセルに既定値が設定されています。 列の 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 格納した値が取得され、表示されます。
イベントを処理する方法の詳細については、次を参照してください。処理とイベントの発生します。
