DataGridView.DefaultValuesNeeded Evento
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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;public event System.Windows.Forms.DataGridViewRowEventHandler? DefaultValuesNeeded;member this.DefaultValuesNeeded : System.Windows.Forms.DataGridViewRowEventHandler Public Custom Event DefaultValuesNeeded As DataGridViewRowEventHandler Tipo de evento
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.
