DataGridView.RowErrorTextNeeded Событие
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Происходит, когда требуется текст ошибки строки.
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
Тип события
Примеры
В следующем примере кода показано использование этого элемента. В этом примере обработчик событий сообщает о возникновении 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.
Дополнительные сведения об обработке событий см. в разделе Обработка и создание событий.