DataGridView.RowErrorTextNeeded Событие

Определение

Пространство имен:

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Происходит, когда требуется текст ошибки строки.

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 

Тип события

DataGridViewRowErrorTextNeededEventHandler

Примеры

В следующем примере кода показано использование этого элемента. В этом примере обработчик событий сообщает о возникновении RowErrorTextNeeded события. Этот отчет поможет вам узнать, когда происходит событие, и может помочь в отладке. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рекомендуется заменить MessageBox.ShowConsole.WriteLine сообщение на или добавить его в многостроочный TextBox.

Чтобы выполнить пример кода, вставьте его в проект, содержащий экземпляр типа DataGridView с именем DataGridView1. Затем убедитесь, что обработчик событий связан с событием 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

Комментарии

Событие RowErrorTextNeeded возникает только в том случае, DataSource если задано DataGridView свойство элемента управления или его VirtualMode свойство имеет значение true. RowErrorTextNeeded Обработка события полезна, если требуется определить ошибку для строки в зависимости от ее состояния и содержащихся в ней значений.

При обработке RowErrorTextNeeded события и указан текст ошибки в обработчике, глиф ошибки отображается в заголовке строки, если свойству ShowRowErrors не присвоено значение false. Когда пользователь перемещает указатель мыши на глиф ошибки, текст ошибки отображается в подсказке.

Событие RowErrorTextNeeded также возникает всякий DataGridViewRow.ErrorText раз, когда извлекается значение свойства.

Свойство можно использовать для DataGridViewRowErrorTextNeededEventArgs.RowIndex определения состояния строки или содержащихся в ней значений, а также использовать эти сведения для изменения или изменения DataGridViewRowErrorTextNeededEventArgs.ErrorText свойства. Это свойство инициализируется значением свойства строки ErrorText , которое переопределяется значением события.

RowErrorTextNeeded Обрабатывайте событие при работе с большими объемами данных, чтобы избежать снижения производительности при установке значения строки ErrorText для нескольких строк. Подробнее см. в разделе Масштабирование элемента управления DataGridView в Windows Forms.

Дополнительные сведения об обработке событий см. в разделе Обработка и создание событий.

См. также раздел

• DataSource
• VirtualMode
• ShowRowErrors
• DataGridViewRowErrorTextNeededEventHandler
• DataGridViewRowErrorTextNeededEventArgs
• ErrorText
• ErrorText
• OnRowErrorTextNeeded(DataGridViewRowErrorTextNeededEventArgs)
• элемент управления DataGridView (Windows Forms)