DataGridView.RowErrorTextNeeded Händelse
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Inträffar när en rads feltext behövs.
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 Händelsetyp
Exempel
Följande kodexempel visar hur den här medlemmen används. I exemplet rapporterar en händelsehanterare om händelsens RowErrorTextNeeded förekomst. Den här rapporten hjälper dig att lära dig när händelsen inträffar och kan hjälpa dig att felsöka. Om du vill rapportera om flera händelser eller händelser som inträffar ofta kan du överväga att MessageBox.Show ersätta med Console.WriteLine eller lägga till meddelandet i en flerradig TextBox.
Om du vill köra exempelkoden klistrar du in den i ett projekt som innehåller en instans av typen DataGridView med namnet DataGridView1. Kontrollera sedan att händelsehanteraren är associerad med RowErrorTextNeeded händelsen.
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
Kommentarer
Händelsen RowErrorTextNeeded inträffar endast när DataSource kontrollens DataGridView egenskap har angetts eller dess VirtualMode egenskap är true.
RowErrorTextNeeded Det är användbart att hantera händelsen när du vill fastställa felet för en rad beroende på dess tillstånd och de värden som den innehåller.
När du hanterar RowErrorTextNeeded händelsen och anger feltext i hanteraren visas ett teckentecken i radrubriken ShowRowErrors om inte egenskapen är inställd på false. När användaren flyttar muspekaren över felglyfen visas feltexten i en knappbeskrivning.
Händelsen RowErrorTextNeeded inträffar också när värdet för DataGridViewRow.ErrorText egenskapen hämtas.
Du kan använda DataGridViewRowErrorTextNeededEventArgs.RowIndex egenskapen för att fastställa tillståndet för en rad eller de värden den innehåller och använda den här informationen för att ändra eller ändra DataGridViewRowErrorTextNeededEventArgs.ErrorText egenskapen. Den här egenskapen initieras med värdet för radegenskapen ErrorText , som händelsevärdet åsidosätter.
Hantera händelsen RowErrorTextNeeded när du arbetar med stora mängder data för att undvika prestandastraff för att ange radvärdet ErrorText för flera rader. Mer information finns i Best Practices for Scaling the Windows Forms DataGridView Control.
Mer information om hur du hanterar händelser finns i Hantera och höja händelser.
