DataGridViewRowErrorTextNeededEventArgs Classe

  • Riferimento

Definizione

Spazio dei nomi:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Fornisce i dati per l'evento RowErrorTextNeeded di un controllo DataGridView.

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

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo tipo. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento RowErrorTextNeeded . Questo report consente di apprendere quando si verifica l'evento e può essere utile per il debug. Per segnalare più eventi o eventi che si verificano di frequente, provare a sostituire Show o Console.WriteLine accodare il messaggio a un oggetto multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di tipo DataGridView denominata DataGridView1. Assicurarsi quindi che il gestore eventi sia associato all'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" );
}

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

Commenti

L'evento RowErrorTextNeeded si verifica solo quando la proprietà del DataGridView controllo DataSource è impostata o la relativa VirtualMode proprietà è true. La gestione dell'evento RowErrorTextNeeded è utile quando si desidera determinare l'errore per una riga a seconda dello stato e dei valori contenuti.

Quando si gestisce l'evento RowErrorTextNeeded e si specifica il testo dell'errore nel gestore, nell'intestazione di riga viene visualizzato un glifo di errore a meno che la DataGridView.ShowRowErrors proprietà non sia impostata su false. Quando l'utente sposta il puntatore del mouse sul glifo di errore, il testo dell'errore viene visualizzato in una descrizione comando.

L'evento RowErrorTextNeeded si verifica anche ogni volta che viene recuperato il valore della DataGridViewRow.ErrorText proprietà.

È possibile utilizzare la RowIndex proprietà per determinare lo stato o il valore di una riga e utilizzare queste informazioni per modificare o modificare la ErrorText proprietà. Questa proprietà viene inizializzata con il valore della proprietà row ErrorText , su cui viene eseguito l'override del valore dell'evento.

Gestire l'evento RowErrorTextNeeded quando si usano grandi quantità di dati per evitare le penalità delle prestazioni dell'impostazione del valore di riga ErrorText per più righe. Per altre informazioni, vedere Procedure consigliate per ridimensionare il controllo DataGridView Windows Form.

Per altre informazioni su come gestire gli eventi, vedere la gestione e generazione di eventi.

Proprietà

ErrorText

Ottiene o imposta il testo di errore per la riga.
RowIndex

Ottiene la riga che ha generato l'evento RowErrorTextNeeded.

Metodi

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.

(Ereditato da Object)
GetHashCode()

Funge da funzione hash predefinita.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.

(Ereditato da Object)
ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.

(Ereditato da Object)

Si applica a

Vedi anche