Esporta (0) Stampa
Espandi tutto

Classe DataGridViewRowErrorTextNeededEventArgs

Aggiornamento: novembre 2007

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

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

public class DataGridViewRowErrorTextNeededEventArgs : EventArgs
public class DataGridViewRowErrorTextNeededEventArgs extends EventArgs
public class DataGridViewRowErrorTextNeededEventArgs extends EventArgs

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 al relativo stato e ai valori in essa contenuti.

Quando si gestisce l'evento RowErrorTextNeeded e si specifica un testo di errore nel gestore, nell'intestazione di riga viene visualizzata un'icona di errore a meno che la proprietà DataGridView.ShowRowErrors non sia impostata su false. Quando il puntatore del mouse viene posizionato sull'icona dell'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à RowIndex per determinare lo stato o il valore di una riga e utilizzare queste informazioni per modificare il valore della proprietà 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 di eventi, vedere Utilizzo degli eventi.

Nell'esempio di codice riportato di seguito viene illustrato l'utilizzo di questo tipo. 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 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" );
}


System.Object
  System.EventArgs
    System.Windows.Forms.DataGridViewRowErrorTextNeededEventArgs

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

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