Taal

DataGridView.RowErrorTextNeeded Gebeurtenis

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll
Bron:
DataGridView.cs
Bron:
DataGridView.cs
Bron:
DataGridView.cs
Bron:
DataGridView.cs
Bron:
DataGridView.cs

Treedt op wanneer de fouttekst van een rij nodig is.

public:
 event System::Windows::Forms::DataGridViewRowErrorTextNeededEventHandler ^ RowErrorTextNeeded;
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

Gebeurtenistype

DataGridViewRowErrorTextNeededEventHandler

Voorbeelden

In het volgende codevoorbeeld ziet u het gebruik van dit lid. In het voorbeeld rapporteert een gebeurtenis-handler over het optreden van de RowErrorTextNeeded gebeurtenis. Dit rapport helpt u te leren wanneer de gebeurtenis plaatsvindt en u kan helpen bij het opsporen van fouten. Als u wilt rapporteren over meerdere gebeurtenissen of gebeurtenissen die vaak optreden, kunt u overwegen het bericht te vervangen MessageBox.ShowConsole.WriteLine door of toe te voegen aan een multiline TextBox.

Als u de voorbeeldcode wilt uitvoeren, plakt u deze in een project dat een exemplaar van het type DataGridView met de naam DataGridView1bevat. Zorg er vervolgens voor dat de gebeurtenis-handler is gekoppeld aan de RowErrorTextNeeded gebeurtenis.

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

Opmerkingen

De RowErrorTextNeeded gebeurtenis treedt alleen op wanneer de DataSource eigenschap van het DataGridView besturingselement is ingesteld of de VirtualMode eigenschap ervan is true. Het afhandelen van de RowErrorTextNeeded gebeurtenis is handig wanneer u de fout voor een rij wilt bepalen, afhankelijk van de status en de waarden die deze bevat.

Wanneer u de RowErrorTextNeeded gebeurtenis afhandelt en fouttekst opgeeft in de handler, wordt er een fout-symbool weergegeven in de rijkop, tenzij de ShowRowErrors eigenschap is ingesteld op false. Wanneer de gebruiker de muisaanwijzer over de fout-glyph beweegt, wordt de fouttekst weergegeven in een knopinfo.

De RowErrorTextNeeded gebeurtenis vindt ook plaats wanneer de waarde van de DataGridViewRow.ErrorText eigenschap wordt opgehaald.

U kunt de DataGridViewRowErrorTextNeededEventArgs.RowIndex eigenschap gebruiken om de status van een rij of de waarden die deze bevat te bepalen en deze informatie te gebruiken om de DataGridViewRowErrorTextNeededEventArgs.ErrorText eigenschap te wijzigen of te wijzigen. Deze eigenschap wordt geïnitialiseerd met de waarde van de rijeigenschap ErrorText , die de gebeurteniswaarde overschrijft.

RowErrorTextNeeded De gebeurtenis afhandelen wanneer u met grote hoeveelheden gegevens werkt om de prestatiestraffen te voorkomen bij het instellen van de rijwaarde ErrorText voor meerdere rijen. Zie Best practices voor het schalen van het Windows Forms DataGridView-besturingselement voor meer informatie.

Zie Gebeurtenissen verwerken en genereren voor meer informatie over het afhandelen van gebeurtenissen.

Van toepassing op

Zie ook