El evento RowErrorTextNeeded sólo se produce cuando se establece la propiedad DataSource del control DataGridView o cuando su propiedad VirtualMode es true. La acción de controlar el evento RowErrorTextNeeded es útil cuando se desea determinar el error en una fila dependiendo de su estado y de los valores que contiene.

Cuando se controla el evento RowErrorTextNeeded y se especifica texto de error en el controlador, aparece un glifo de error en el encabezado de fila, a menos que la propiedad DataGridView..::.ShowRowErrors se establezca en false. Cuando el usuario mueve el puntero del mouse sobre el glifo de error, el texto del error aparece en una información sobre herramientas.

El evento RowErrorTextNeeded también se produce siempre que se recupera el valor de la propiedad DataGridViewRow..::.ErrorText.

Se puede utilizar la propiedad RowIndex para determinar el estado o el valor de una fila y utilizar esta información para cambiar o modificar la propiedad ErrorText. Esta propiedad se inicializa con el valor de la propiedad ErrorText de la fila, que es reemplazado por el valor del evento.

Controle el evento RowErrorTextNeeded cuando trabaje con grandes volúmenes de datos a fin de evitar una reducción del rendimiento al establecer el valor de la propiedad ErrorText de una fila para varias filas. Para obtener más información, vea Procedimientos recomendados para ajustar la escala del control DataGridView en formularios Windows Forms.

Para obtener más información sobre la forma de controlar eventos, vea Utilizar eventos.

En el ejemplo de código siguiente se muestra el uso de este tipo. En el ejemplo, un controlador de eventos notifica que se ha producido el evento RowErrorTextNeeded. Este informe es útil para saber cuándo se produce el evento y puede servir de ayuda en la depuración. Para informar sobre varios eventos o sobre eventos que se producen frecuentemente, considere la posibilidad de reemplazar Show por Console..::.WriteLine o de agregar el mensaje a un TextBox de varias líneas.

Para ejecutar el código de ejemplo, péguelo en un proyecto que contenga una instancia de tipo DataGridView denominada DataGridView1. A continuación, asegúrese de que el controlador de eventos esté asociado al evento RowErrorTextNeeded.

Private Sub DataGridView1_RowErrorTextNeeded(sender as Object, e as DataGridViewRowErrorTextNeededEventArgs) _ 
     Handles DataGridView1.RowErrorTextNeeded

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"RowErrorTextNeeded Event")

End Sub

private void DataGridView1_RowErrorTextNeeded(Object sender, DataGridViewRowErrorTextNeededEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ErrorText", e.ErrorText );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "RowIndex", e.RowIndex );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "RowErrorTextNeeded Event" );
}

Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework

Referencia

Otros recursos