DataGridView.RowErrorTextNeeded Zdarzenie
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Występuje, gdy potrzebny jest tekst błędu wiersza.
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
Typ zdarzenia
Przykłady
W poniższym przykładzie kodu pokazano użycie tego elementu członkowskiego. W tym przykładzie program obsługi zdarzeń zgłasza wystąpienie RowErrorTextNeeded zdarzenia. Ten raport pomaga dowiedzieć się, kiedy wystąpi zdarzenie, i może pomóc w debugowaniu. Aby zgłosić wiele zdarzeń lub często występujących zdarzeń, rozważ zastąpienie MessageBox.Show komunikatu ciągiem Console.WriteLine lub dołączenie go do wielowierszowego TextBoxelementu .
Aby uruchomić przykładowy kod, wklej go w projekcie zawierającym wystąpienie typu DataGridView o nazwie DataGridView1
. Następnie upewnij się, że program obsługi zdarzeń jest skojarzony ze zdarzeniem RowErrorTextNeeded .
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
Uwagi
Zdarzenie RowErrorTextNeeded występuje tylko wtedy, gdy DataSource właściwość kontrolki DataGridView jest ustawiona lub jej VirtualMode właściwość to true
. Obsługa zdarzenia RowErrorTextNeeded jest przydatna, gdy chcesz określić błąd dla wiersza w zależności od jego stanu i wartości, które zawiera.
Podczas obsługi zdarzenia i określania RowErrorTextNeeded tekstu błędu w procedurze obsługi w nagłówku wiersza pojawia się symbol błędu, chyba że ShowRowErrors właściwość ma wartość false
. Gdy użytkownik przesuwa wskaźnik myszy nad glifem błędu, tekst błędu pojawia się w etykietce narzędzia.
Zdarzenie RowErrorTextNeeded występuje również za każdym razem, gdy zostanie pobrana wartość DataGridViewRow.ErrorText właściwości.
Możesz użyć DataGridViewRowErrorTextNeededEventArgs.RowIndex właściwości , aby określić stan wiersza lub wartości, które zawiera, i użyć tych informacji, aby zmienić lub zmodyfikować DataGridViewRowErrorTextNeededEventArgs.ErrorText właściwość. Ta właściwość jest inicjowana z wartością właściwości wiersza ErrorText , która zastępuje wartość zdarzenia.
RowErrorTextNeeded Obsłuż zdarzenie podczas pracy z dużą ilością danych, aby uniknąć kar za wydajność ustawiania wartości wiersza ErrorText dla wielu wierszy. Aby uzyskać więcej informacji, zobacz Best Practices for Scaling the Windows Forms DataGridView Control (Najlepsze rozwiązania dotyczące skalowania kontrolki DataGridView).
Aby uzyskać więcej informacji na temat obsługi zdarzeń, zobacz Obsługa i podnoszenie zdarzeń.
Dotyczy
Zobacz też
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla