DataGridView.RowErrorTextNeeded Evento

  • Referencia

Definición

Espacio de nombres:
System.Windows.Forms
Ensamblado:
System.Windows.Forms.dll

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

public:
 event System::Windows::Forms::DataGridViewRowErrorTextNeededEventHandler ^ RowErrorTextNeeded;
public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler RowErrorTextNeeded;
public event System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler? RowErrorTextNeeded;
member this.RowErrorTextNeeded : System.Windows.Forms.DataGridViewRowErrorTextNeededEventHandler 
Public Custom Event RowErrorTextNeeded As DataGridViewRowErrorTextNeededEventHandler

Tipo de evento

DataGridViewRowErrorTextNeededEventHandler

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este miembro. En el ejemplo, un controlador de eventos informa sobre la aparición del RowErrorTextNeeded evento. Este informe le ayuda a aprender cuándo se produce el evento y puede ayudarle a depurar. Para informar sobre varios eventos o eventos que se producen con frecuencia, considere la posibilidad de reemplazar MessageBox.ShowConsole.WriteLine por o anexar el mensaje a una línea TextBoxmúltiple.

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 RowErrorTextNeeded evento.

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" );
}

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

Comentarios

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

Al controlar el RowErrorTextNeeded evento y especificar texto de error en el controlador, aparece un glifo de error en el encabezado de fila a menos que la ShowRowErrors propiedad esté establecida falseen . 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 RowErrorTextNeeded evento también se produce cada vez que se recupera el valor de la DataGridViewRow.ErrorText propiedad.

Puede usar la DataGridViewRowErrorTextNeededEventArgs.RowIndex propiedad para determinar el estado de una fila o los valores que contiene y usar esta información para cambiar o modificar la DataGridViewRowErrorTextNeededEventArgs.ErrorText propiedad. Esta propiedad se inicializa con el valor de la propiedad row ErrorText , que el valor de evento invalida.

Controle el RowErrorTextNeeded evento al trabajar con grandes cantidades de datos para evitar las penalizaciones de rendimiento de establecer el valor de fila ErrorText para varias filas. Para obtener más información, consulte Procedimientos recomendados para ajustar la escala del control DataGridView en Windows Forms.

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

Se aplica a

Consulte también