DataGridView.RowErrorTextNeeded-Ereignis

Das RowErrorTextNeeded-Ereignis tritt nur ein, wenn die DataSource-Eigenschaft des DataGridView-Steuerelements festgelegt ist oder dessen VirtualMode-Eigenschaft true ist. Das Behandeln des RowErrorTextNeeded-Ereignisses empfiehlt sich, wenn der Fehler für eine Zeile anhand ihres Zustands und der in ihr enthaltenen Werte bestimmt werden soll.

Wenn Sie das RowErrorTextNeeded-Ereignis behandeln und den Fehlertext im Handler angeben, wird ein Fehlersymbol im Zeilenheader angezeigt, es sei denn, die ShowRowErrors-Eigenschaft ist auf false festgelegt. Wenn der Mauszeiger über das Fehlersymbol bewegt wird, wird der Fehlertext in einer QuickInfo angezeigt.

Das RowErrorTextNeeded-Ereignis tritt auch bei jedem Abrufen des Werts der DataGridViewRow.ErrorText-Eigenschaft ein.

Sie können mithilfe der DataGridViewRowErrorTextNeededEventArgs.RowIndex-Eigenschaft den Zustand einer Zeile oder die darin enthaltenen Werte bestimmen, und Sie können mithilfe dieser Informationen die DataGridViewRowErrorTextNeededEventArgs.ErrorText-Eigenschaft ändern. Diese Eigenschaft wird mit dem Wert der Eigenschaft der Zeile ErrorText initialisiert, die durch den Ereigniswert überschrieben wird.

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

Weitere Informationen über die Behandlung von Ereignissen finden Sie unter Behandeln von Ereignissen.

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel erstellt ein Ereignishandler einen Bericht über das Eintreten des RowErrorTextNeeded-Ereignisses. Diesem Bericht können Sie entnehmen, wann das Ereignis eintritt. Außerdem kann der Bericht Sie beim Debuggen unterstützen. Wenn Sie einen Bericht über mehrere Ereignisse oder häufig eintretende Ereignisse erstellen möchten, sollten Sie System.Windows.Forms.MessageBox.Show durch System.Console.WriteLine ersetzen oder die Meldung an ein mehrzeiliges TextBox anfügen.

Fügen Sie den Beispielcode zum Ausführen in ein Projekt ein, das eine Instanz vom Typ DataGridView mit dem Namen DataGridView1 enthält. Stellen Sie anschließend 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" );
}

Windows 98, Windows Server 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

Microsoft .NET Framework 3.0 wird unter Windows Vista, Microsoft Windows XP SP2 und Windows Server 2003 SP1 unterstützt.

.NET Framework