DataGridView.RowErrorTextNeeded Ereignis

Definition

Tritt ein, wenn der Fehlertext einer Zeile benötigt wird.

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 

Ereignistyp

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses RowErrorTextNeeded . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Ihnen beim Debuggen helfen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie erwägen, die Nachricht durch Console.WriteLine ein mehrzeilesiges TextBoxzu ersetzen MessageBox.Show oder anzufügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance vom Typ DataGridView enthältDataGridView1. Stellen Sie dann sicher, dass der Ereignishandler dem RowErrorTextNeeded Ereignis zugeordnet ist.

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

Hinweise

Das RowErrorTextNeeded -Ereignis tritt nur auf, wenn die DataSource -Eigenschaft des DataGridView -Steuerelements festgelegt oder seine VirtualMode -Eigenschaft ist true. Die Behandlung des Ereignisses RowErrorTextNeeded ist nützlich, wenn Sie den Fehler für eine Zeile abhängig von ihrem Zustand und den darin enthaltenen Werten ermitteln möchten.

Wenn Sie das RowErrorTextNeeded Ereignis behandeln und Fehlertext im Handler angeben, wird im Zeilenheader eine Fehlersymbolzeile angezeigt, es sei denn, die ShowRowErrors Eigenschaft ist auf falsefestgelegt. Wenn der Benutzer den Mauszeiger über die Fehlersymbole bewegt, wird der Fehlertext in einer QuickInfo angezeigt.

Das RowErrorTextNeeded -Ereignis tritt auch auf, wenn der Wert der DataGridViewRow.ErrorText -Eigenschaft abgerufen wird.

Sie können die DataGridViewRowErrorTextNeededEventArgs.RowIndex -Eigenschaft verwenden, um den Zustand einer Zeile oder die darin enthaltenen Werte zu bestimmen, und diese Informationen verwenden, um die DataGridViewRowErrorTextNeededEventArgs.ErrorText Eigenschaft zu ändern oder zu ändern. Diese Eigenschaft wird mit dem Wert der Zeileneigenschaft ErrorText initialisiert, die vom Ereigniswert überschrieben wird.

Behandeln Sie das RowErrorTextNeeded Ereignis, wenn Sie mit großen Datenmengen arbeiten, um leistungseinbußen beim Festlegen des Zeilenwerts ErrorText für mehrere Zeilen zu vermeiden. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.

Gilt für:

Weitere Informationen