DataGridViewRowErrorTextNeededEventArgs Klasse
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.
Stellt Daten für das RowErrorTextNeeded-Ereignis eines DataGridView-Steuerelements bereit.
public ref class DataGridViewRowErrorTextNeededEventArgs : EventArgs
public class DataGridViewRowErrorTextNeededEventArgs : EventArgs
type DataGridViewRowErrorTextNeededEventArgs = class
inherit EventArgs
Public Class DataGridViewRowErrorTextNeededEventArgs
Inherits EventArgs
- Vererbung
Beispiele
Im folgenden Codebeispiel wird die Verwendung dieses Typs 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 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 DataGridView Steuerelementeigenschaft DataSource festgelegt ist oder die 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 DataGridView.ShowRowErrors Eigenschaft ist auf false
festgelegt. 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 RowIndex -Eigenschaft verwenden, um den Zustand oder Wert einer Zeile zu bestimmen, und diese Informationen verwenden, um die 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.
Eigenschaften
ErrorText |
Ruft den Fehlertext für die Zeile ab oder legt diesen fest. |
RowIndex |
Ruft die Zeile ab, die das RowErrorTextNeeded-Ereignis ausgelöst hat. |
Methoden
Equals(Object) |
Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object) |
GetHashCode() |
Fungiert als Standardhashfunktion. (Geerbt von Object) |
GetType() |
Ruft den Type der aktuellen Instanz ab. (Geerbt von Object) |
MemberwiseClone() |
Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object) |
ToString() |
Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object) |