DataGridViewCellValueEventHandler 代理人

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

來源:

DataGridViewEventHandlers.cs

表示將處理 CellValueNeeded 的 CellValuePushed 事件或 DataGridView 事件的方法。

C#

public delegate void DataGridViewCellValueEventHandler(object? sender, DataGridViewCellValueEventArgs e);

參數

sender

Object

事件的來源。

e

DataGridViewCellValueEventArgs

DataGridViewCellValueEventArgs，其中包含事件資料。

範例

下列程式碼範例會 CellValuePushed 處理 事件，以在資料存放區物件中儲存更新和新專案。 此範例是參考主題中較大範例的 DataGridView.VirtualMode 一部分。

C#

#region "data store maintance"
const int initialValue = -1;

private void dataGridView1_CellValueNeeded(object sender,
    DataGridViewCellValueEventArgs e)
{
    if (store.ContainsKey(e.RowIndex))
    {
        // Use the store if the e value has been modified 
        // and stored.            
        e.Value = store[e.RowIndex];
    }
    else if (newRowNeeded && e.RowIndex == numberOfRows)
    {
        if (dataGridView1.IsCurrentCellInEditMode)
        {
            e.Value = initialValue;
        }
        else
        {
            // Show a blank value if the cursor is just resting
            // on the last row.
            e.Value = String.Empty;
        }
    }
    else
    {
        e.Value = e.RowIndex;
    }
}

private void dataGridView1_CellValuePushed(object sender,
    DataGridViewCellValueEventArgs e)
{
    store.Add(e.RowIndex, int.Parse(e.Value.ToString()));
}
#endregion

private Dictionary<int, int> store = new Dictionary<int, int>();

備註

使用此委派在 控制項中實作 DataGridView 虛擬模式。 如需虛擬模式的詳細資訊，請參閱Windows Forms DataGridView 控制項中的虛擬模式。

建立 DataGridViewCellValueEventHandler 委派時，必須識別處理事件的方法。 若要使事件與您的事件處理常式產生關聯，請將委派的執行個體 (Instance) 加入至事件。 除非您移除委派，否則每當事件發生時就會呼叫事件處理常式。 如需事件處理常式委派的詳細資訊，請參閱 處理和引發事件。

擴充方法

適用於

另請參閱

• DataGridView
• VirtualMode
• CellValueNeeded
• CellValuePushed
• DataGridViewCellValueEventArgs
• Windows Form DataGridView 控制項中的虛擬模式