DataGridView.RowErrorTextNeeded Evento

  • Riferimento

Definizione

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

Si verifica quando è necessario il testo dell'errore di una riga.

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 evento

DataGridViewRowErrorTextNeededEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. 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 eseguire il debug. Per segnalare più eventi o eventi che si verificano spesso, è consigliabile sostituire MessageBox.Show con Console.WriteLine o aggiungere il messaggio a una 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 è impostata o la DataSource relativa VirtualMode proprietà è true. La gestione dell'evento RowErrorTextNeeded è utile quando si vuole 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 di errore nel gestore, viene visualizzato un glifo di errore nell'intestazione di riga a meno che la 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 usare la DataGridViewRowErrorTextNeededEventArgs.RowIndex proprietà per determinare lo stato di una riga o i valori contenuti e usare queste informazioni per modificare o modificare la DataGridViewRowErrorTextNeededEventArgs.ErrorText proprietà. Questa proprietà viene inizializzata con il valore della proprietà di riga ErrorText , che il valore dell'evento esegue l'override.

Gestire l'evento quando si usano grandi quantità di dati per evitare le penali per le prestazioni dell'impostazione RowErrorTextNeeded del valore della 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.

Si applica a

Vedi anche