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 Vorkommen des RowErrorTextNeeded Ereignisses. Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis auftritt und Sie beim Debuggen unterstützen können. Wenn Sie über mehrere Ereignisse oder ereignisse berichten möchten, die häufig auftreten, sollten Sie die Nachricht durch Console.WriteLine eine mehrlineige TextBoxNachricht ersetzen Show oder anfügen.

Um den Beispielcode auszuführen, fügen Sie sie in ein Projekt ein, das eine Instanz des Typs DataGridView namens enthält DataGridView1. 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 oder die VirtualMode Eigenschaft festgelegt trueist. Die Behandlung des RowErrorTextNeeded Ereignisses ist nützlich, wenn Sie den Fehler für eine Zeile je nach Zustand und den enthaltenen Werten ermitteln möchten.

Wenn Sie das RowErrorTextNeeded Ereignis behandeln und Fehlertext im Handler angeben, wird eine Fehler-Glyph in der Zeilenüberschrift angezeigt, es sei denn, die DataGridView.ShowRowErrors Eigenschaft ist auf falsefestgelegt. Wenn der Benutzer den Mauszeiger über die Fehlerglyphen verschiebt, wird der Fehlertext in einer QuickInfo angezeigt.

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

Mithilfe der RowIndex Eigenschaft können Sie den Zustand oder den Wert einer Zeile 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 der Ereigniswert außer Kraft gesetzt wird.

Behandeln Sie das RowErrorTextNeeded Ereignis beim Arbeiten mit großen Datenmengen, um die Leistungsstrafen zu vermeiden, um den Zeilenwert ErrorText für mehrere Zeilen festzulegen. 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:

Siehe auch