DataGridViewRowErrorTextNeededEventArgs Klasse

  • Referenz

Definition

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

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
Object
EventArgs
DataGridViewRowErrorTextNeededEventArgs

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 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 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)

Gilt für:

Weitere Informationen