DataGridViewRowErrorTextNeededEventArgs Classe
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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à
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) |