DataGridView.RowErrorTextNeeded Ereignis
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Tritt auf, 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 Elements veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des RowErrorTextNeeded Ereignisses. Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis auftritt und Sie beim Debuggen unterstützen kann. Wenn Sie über mehrere Ereignisse oder ereignisse berichten möchten, die häufig auftreten, erwägen Sie, die Nachricht durch MessageBox.Show eine mehrteilige Console.WriteLineNachricht zu ersetzen TextBox oder sie anzufügen.
Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz des Typs DataGridView namens DataGridView1enthält. 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 wird oder seine VirtualMode Eigenschaft lautet true. Die Behandlung des RowErrorTextNeeded Ereignisses ist nützlich, wenn Sie den Fehler für eine Zeile abhängig vom Status und den darin enthaltenen Werten ermitteln möchten.
Wenn Sie das RowErrorTextNeeded Ereignis behandeln und Fehlertext im Handler angeben, wird eine Fehlerglyphe in der Zeilenüberschrift angezeigt, es sei denn, die ShowRowErrors Eigenschaft ist auf falsefestgelegt. Wenn der Benutzer den Mauszeiger über die Fehlerglyphe bewegt, wird der Fehlertext in einer QuickInfo angezeigt.
Das RowErrorTextNeeded Ereignis tritt auch auf, wenn der Wert der DataGridViewRow.ErrorText Eigenschaft abgerufen wird.
Mit der DataGridViewRowErrorTextNeededEventArgs.RowIndex Eigenschaft können Sie den Status einer Zeile oder der darin enthaltenen Werte ermitteln 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 der Ereigniswert überschreibt.
Behandeln Sie das RowErrorTextNeeded Ereignis beim Arbeiten mit großen Datenmengen, um leistungseinbußen beim Festlegen des Zeilenwerts ErrorText für mehrere Zeilen zu vermeiden. Weitere Informationen finden Sie unter Bewährte Methoden zum Skalieren des Windows Forms DataGridView-Steuerelements.
Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Behandeln und Auslösen von Ereignissen.
