Esta documentación está archivada y no tiene mantenimiento.

DataGridView.RowErrorTextNeeded (Evento)

Se produce cuando es necesario el texto de error de una fila.

Espacio de nombres: System.Windows.Forms
Ensamblado: System.Windows.Forms (en system.windows.forms.dll)

public event DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded
/** @event */
public void add_RowErrorTextNeeded (DataGridViewRowErrorTextNeededEventHandler value)

/** @event */
public void remove_RowErrorTextNeeded (DataGridViewRowErrorTextNeededEventHandler value)

En JScript, se pueden controlar los eventos que define una clase, pero no se pueden definir unos propios.
No aplicable.

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

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

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

Puede utilizar la propiedad DataGridViewRowErrorTextNeededEventArgs.RowIndex para determinar el estado de una fila o los valores que contiene, y utilizar esta información para cambiar o modificar la propiedad DataGridViewRowErrorTextNeededEventArgs.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 para evitar penalizaciones de rendimiento al establecer el valor de la fila ErrorText 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 el control de eventos, vea Utilizar eventos.

En el ejemplo de código siguiente se muestra el uso de este miembro. 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 System.Windows.Forms.MessageBox.Show por System.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 con la denominación DataGridView1. A continuación, asegúrese de que el controlador de eventos esté asociado al evento RowErrorTextNeeded.

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 98, Windows 2000 Service Pack 4, Windows Millennium, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0
Mostrar: