DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded DataGridView.RowErrorTextNeeded Event

Definition

Tritt ein, wenn der Fehlertext einer Zeile benötigt wird.Occurs when a row's error text is needed.

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 

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht.The following code example demonstrates the use of this member. Im Beispiel meldet ein Ereignishandler das Vorkommen des RowErrorTextNeeded Ereignisses.In the example, an event handler reports on the occurrence of the RowErrorTextNeeded event. Mit diesem Bericht können Sie lernen, wann das Ereignis auftritt und Sie beim Debuggen unterstützen können.This report helps you to learn when the event occurs and can assist you in debugging. Wenn Sie mehrere Ereignisse oder Ereignisse, die häufig auftreten, melden möchten, MessageBox.Show empfiehlt Console.WriteLine es sich, durch zu ersetzen oder die Nachricht TextBoxan eine mehrzeilige anfügen.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine Instanz DataGridView des DataGridView1Typs mit dem Namen enthält.To run the example code, paste it into a project that contains an instance of type DataGridView named DataGridView1. Stellen Sie dann sicher, dass der Ereignishandler dem RowErrorTextNeeded Ereignis zugeordnet ist.Then ensure that the event handler is associated with the RowErrorTextNeeded event.

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 DataSource , wenn die DataGridView -Eigenschaft des-Steuer VirtualMode Elements fest truegelegt ist oder die-Eigenschaft ist.The RowErrorTextNeeded event occurs only when the DataSource property of the DataGridView control is set or its VirtualMode property is true. Die Behandlung RowErrorTextNeeded des-Ereignisses ist hilfreich, wenn Sie den Fehler für eine Zeile abhängig von Ihrem Status und den darin enthaltenen Werten bestimmen möchten.Handling the RowErrorTextNeeded event is useful when you want to determine the error for a row depending on its state and the values it contains.

Wenn Sie das RowErrorTextNeeded -Ereignis behandeln und den Fehlertext im-Handler angeben, wird ein Fehler Symbol im Zeilen Header angezeigt, es sei denn, falsedie ShowRowErrors -Eigenschaft ist auf festgelegt.When you handle the RowErrorTextNeeded event and specify error text in the handler, an error glyph appears in the row header unless the ShowRowErrors property is set to false. Wenn der Benutzer den Mauszeiger über das Fehler Symbol bewegt, wird der Fehlertext in einer QuickInfo angezeigt.When the user moves the mouse pointer over the error glyph, the error text appears in a ToolTip.

Das RowErrorTextNeeded Ereignis tritt auch DataGridViewRow.ErrorText auf, wenn der Wert der Eigenschaft abgerufen wird.The RowErrorTextNeeded event also occurs whenever the value of the DataGridViewRow.ErrorText property is retrieved.

Sie können die- DataGridViewRowErrorTextNeededEventArgs.RowIndex Eigenschaft verwenden, um den Status einer Zeile oder die darin enthaltenen Werte zu ermitteln. verwenden Sie diese Informationen, um die DataGridViewRowErrorTextNeededEventArgs.ErrorText Eigenschaft zu ändern oder zu ändern.You can use the DataGridViewRowErrorTextNeededEventArgs.RowIndex property to determine the state of a row or the values it contains, and use this information to change or modify the DataGridViewRowErrorTextNeededEventArgs.ErrorText property. Diese Eigenschaft wird mit dem Wert der Zeilen ErrorText Eigenschaft initialisiert, den der Ereignis Wert überschreibt.This property is initialized with the value of the row ErrorText property, which the event value overrides.

Behandeln Sie RowErrorTextNeeded das-Ereignis bei der Arbeit mit großen Datenmengen, um die Leistungseinbußen beim Festlegen ErrorText des Zeilen Werts für mehrere Zeilen zu vermeiden.Handle the RowErrorTextNeeded event when working with large amounts of data to avoid the performance penalties of setting the row ErrorText value for multiple rows. Weitere Informationen finden Sie unter Empfohlene Vorgehensweisen für das Skalieren des DataGridView-Steuerelements in Windows Forms.For more information, see Best Practices for Scaling the Windows Forms DataGridView Control.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.For more information about how to handle events, see Handling and Raising Events.

Gilt für:

Siehe auch