DataGridView.DefaultValuesNeeded Evento

Definición

Tiene lugar cuando el usuario escribe nuevos registros en la fila para que se pueda rellenar con valores predeterminados.Occurs when the user enters the row for new records so that it can be populated with default values.

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 

Ejemplos

En el ejemplo de código siguiente se muestra cómo se puede controlar este evento.The following code example illustrates how this event can be handled. En el ejemplo, las celdas de las columnas especificadas se rellenan con valores predeterminados.In the example, cells for the given columns are populated with default values. En el caso de la columna CustomerID, el valor se recupera de un método independiente (no implementado) que genera un identificador de cliente único.For the CustomerID column, the value is retrieved from a separate method (not implemented) that generates a unique customer ID.

Para ejecutar este ejemplo, reemplace los nombres de columna por los nombres de los objetos de columna de un control DataGridView real y proporcione los valores predeterminados adecuados.To run this example, replace the column names with the names of the column objects from an actual DataGridView control and provide appropriate default values. Al especificar las columnas por nombre, debe utilizar el nombre del objeto de columna y no el texto del encabezado de columna.When specifying columns by name, you must use the name of the column object and not the column header text.

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 de nuevos registros cuando el usuario escribe la fila.This event lets you populate the row for new records when the user enters the row. Los valores iniciales de la fila provienen de la propiedad DefaultNewRowValue del DataGridViewCell devuelto por la propiedad CellTemplate de cada columna.Initial values for the row come from the DefaultNewRowValue property of the DataGridViewCell returned by each column's CellTemplate property.

En el modo de enlace de datos, todos los valores de celda de las columnas enlazadas a datos se almacenan en el origen de datos externo.In data bound mode, all cell values for data bound columns are stored in the external data source. 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 evento DefaultValuesNeeded.When the user enters the row for new records, a new row is created in the data source before the DefaultValuesNeeded event occurs. Al rellenar la propiedad DataGridViewRowEventArgs.Row en el controlador de eventos, los valores se agregan directamente al origen de datos.When you populate the DataGridViewRowEventArgs.Row property in your event handler, the values are added directly to the data source.

En el modo virtual, después de que se produzca este evento, el evento CellValuePushed se produce para cada celda de la nueva fila, de modo que pueda almacenar los valores predeterminados en el almacén de datos personalizado.In virtual mode, after this event occurs, the CellValuePushed event occurs for each cell in the new row so that you can store the default values in your custom data store. A continuación, se produce el evento CellValueNeeded para cada celda de la nueva fila, recuperando los valores que almacenó en el evento CellValuePushed, que se muestran a continuación.Then, the CellValueNeeded event occurs for each cell in the new row, retrieving the values that you stored in the CellValuePushed event, which are then displayed.

Para obtener más información acerca de cómo controlar eventos, vea controlar y provocar eventos.For more information about how to handle events, see Handling and Raising Events.

Se aplica a

Consulte también: