DataGridViewRowErrorTextNeededEventArgs Clase

  • Referencia

Definición

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

Proporciona datos para el evento RowErrorTextNeeded de un control DataGridView.

public ref class DataGridViewRowErrorTextNeededEventArgs : EventArgs
public class DataGridViewRowErrorTextNeededEventArgs : EventArgs
type DataGridViewRowErrorTextNeededEventArgs = class
    inherit EventArgs
Public Class DataGridViewRowErrorTextNeededEventArgs
Inherits EventArgs
Herencia
Object
EventArgs
DataGridViewRowErrorTextNeededEventArgs

Ejemplos

En el ejemplo de código siguiente se muestra el uso de este tipo. 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 Show por Console.WriteLine 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 propiedad de DataGridView control DataSource se establece o su VirtualMode propiedad es true. Controlar el RowErrorTextNeeded evento es útil cuando se 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 el texto de error en el controlador, aparece un glifo de error en el encabezado de fila a menos que la DataGridView.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 RowIndex propiedad para determinar el estado o el valor de una fila y usar esta información para cambiar o modificar la ErrorText propiedad. Esta propiedad se inicializa con el valor de la propiedad row ErrorText , que invalida el valor del evento.

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.

Propiedades

ErrorText

Obtiene o establece el texto de error para la fila.
RowIndex

Obtiene la fila que ha provocado el evento RowErrorTextNeeded.

Métodos

Equals(Object)

Determina si el objeto especificado es igual que el objeto actual.

(Heredado de Object)
GetHashCode()

Sirve como la función hash predeterminada.

(Heredado de Object)
GetType()

Obtiene el Type de la instancia actual.

(Heredado de Object)
MemberwiseClone()

Crea una copia superficial del Object actual.

(Heredado de Object)
ToString()

Devuelve una cadena que representa el objeto actual.

(Heredado de Object)

Se aplica a

Consulte también