Questa pagina è stata utile?
I suggerimenti relativi al contenuto di questa pagina sono importanti. Comunicaceli.
Altri suggerimenti?
1500 caratteri rimanenti
Evento RowErrorTextNeeded
Collapse the table of content
Expand the table of content

Evento DataGridView.RowErrorTextNeeded

Aggiornamento: novembre 2007

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

Spazio dei nomi:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

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

JScript non supporta gli eventi.

L'evento RowErrorTextNeeded si verifica solo se è impostata la proprietà DataSource del controllo DataGridView o se la relativa proprietà VirtualMode è true. La gestione dell'evento RowErrorTextNeeded è utile quando si desidera determinare l'errore di una riga in base allo stato e ai valori della riga.

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

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

È possibile utilizzare la proprietà DataGridViewRowErrorTextNeededEventArgs.RowIndex per determinare lo stato o i valori di una riga. Questa informazione può essere utilizzata per modificare il valore della proprietà DataGridViewRowErrorTextNeededEventArgs.ErrorText. Questa proprietà viene inizializzata sul valore della proprietà ErrorText della riga, che esegue l'override del valore dell'evento.

Quando si utilizzano grandi quantità di dati, per evitare una diminuzione nelle prestazioni a causa dell'impostazione del valore della proprietà ErrorText per più righe, si consiglia di gestire l'evento RowErrorTextNeeded. Per ulteriori informazioni, vedere Procedure consigliate per ridimensionare il controllo DataGridView Windows Form.

Per ulteriori informazioni sulla gestione degli eventi, vedere Utilizzo degli eventi.

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questo membro. Nell'esempio, un gestore eventi genera report sull'occorrenza dell'evento RowErrorTextNeeded. Questo report consente di capire quando si verifica l'evento offrendo un supporto per il debug. Per generare report su più eventi o su eventi che si verificano frequentemente, sostituire MessageBox.Show con Console.WriteLine o aggiungere il messaggio a un controllo TextBox su più righe.

Per eseguire il codice di esempio, incollarlo in un progetto che contenga 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" );
}


Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

.NET Framework

Supportato in: 3.5, 3.0, 2.0

Aggiunte alla community

AGGIUNGI
Mostra:
© 2015 Microsoft