DataGridView.DefaultValuesNeeded Evento

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Si verifica quando gli utenti immettono la riga per i nuovi record, in modo da potervi inserire i valori predefiniti.

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 

Tipo evento

DataGridViewRowEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato come gestire questo evento. Nell'esempio le celle per le colonne specificate vengono popolate con valori predefiniti. Per la CustomerID colonna, il valore viene recuperato da un metodo separato (non implementato) che genera un ID cliente univoco.

Per eseguire questo esempio, sostituire i nomi delle colonne con i nomi degli oggetti colonna da un controllo effettivo DataGridView e specificare i valori predefiniti appropriati. Quando si specificano colonne in base al nome, è necessario utilizzare il nome dell'oggetto colonna e non il testo dell'intestazione di colonna.

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

Commenti

Questo evento consente di popolare la riga per i nuovi record quando l'utente immette la riga. I valori iniziali per la riga provengono dalla DefaultNewRowValue proprietà dell'oggetto DataGridViewCell restituito dalla proprietà di CellTemplate ogni colonna.

In modalità associata a dati, tutti i valori di cella per le colonne associate a dati vengono archiviati nell'origine dati esterna. Quando l'utente immette la riga per i nuovi record, viene creata una nuova riga nell'origine dati prima che si verifichi l'evento DefaultValuesNeeded . Quando si popola la DataGridViewRowEventArgs.Row proprietà nel gestore eventi, i valori vengono aggiunti direttamente all'origine dati.

In modalità virtuale, dopo che questo evento si verifica, l'evento CellValuePushed si verifica per ogni cella nella nuova riga in modo che sia possibile archiviare i valori predefiniti nell'archivio dati personalizzato. L'evento CellValueNeeded si verifica quindi per ogni cella nella nuova riga, recuperando i valori archiviati nell'evento CellValuePushed , che vengono quindi visualizzati.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.

Vedi anche

• Controllo DataGridView (Windows Form)