DataGridView.DefaultValuesNeeded Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Tiene lugar cuando el usuario escribe nuevos registros en la fila para que se pueda rellenar con valores predeterminados.

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 de evento

DataGridViewRowEventHandler

Ejemplos

En el ejemplo de código siguiente se muestra cómo se puede controlar este evento. En el ejemplo, las celdas de las columnas especificadas se rellenan con valores predeterminados. Para la CustomerID columna, el valor se recupera de un método independiente (no implementado) que genera un identificador de cliente único.

Para ejecutar este ejemplo, reemplace los nombres de columna por los nombres de los objetos de columna de un control real DataGridView y proporcione los valores predeterminados adecuados. Al especificar columnas por nombre, debe usar el nombre del objeto de columna y no el texto del encabezado de columna.

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

Comentarios

Este evento le permite rellenar la fila para los nuevos registros cuando el usuario escribe la fila. Los valores iniciales de la fila proceden de la DefaultNewRowValue propiedad del DataGridViewCell devuelto por la propiedad de CellTemplate cada columna.

En el modo enlazado a datos, todos los valores de celda de las columnas enlazadas a datos se almacenan en el origen de datos externo. Cuando el usuario escribe la fila para los nuevos registros, se crea una nueva fila en el origen de datos antes de que se produzca el DefaultValuesNeeded evento. Al rellenar la propiedad en el DataGridViewRowEventArgs.Row controlador de eventos, los valores se agregan directamente al origen de datos.

En el modo virtual, después de que se produzca este evento, el CellValuePushed evento se produce para cada celda de la nueva fila para que pueda almacenar los valores predeterminados en el almacén de datos personalizado. A continuación, el CellValueNeeded evento se produce para cada celda de la nueva fila, recuperando los valores almacenados en el CellValuePushed evento, que a continuación se muestran.

Para obtener más información acerca de cómo controlar eventos, vea controlar y provocar eventos.

Consulte también

• DataGridView (Control, formularios Windows Forms)