DataGridView.RowErrorTextNeeded Zdarzenie

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Windows.Forms
Zestaw:
System.Windows.Forms.dll

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

DataGridViewRowErrorTextNeededEventHandler

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ż