DataGridViewRowErrorTextNeededEventArgs Класс

Определение

Предоставляет данные для события RowErrorTextNeeded элемента управления DataGridView.

public ref class DataGridViewRowErrorTextNeededEventArgs : EventArgs
public class DataGridViewRowErrorTextNeededEventArgs : EventArgs
type DataGridViewRowErrorTextNeededEventArgs = class
    inherit EventArgs
Public Class DataGridViewRowErrorTextNeededEventArgs
Inherits EventArgs
Наследование
DataGridViewRowErrorTextNeededEventArgs

Примеры

В следующем примере кода показано использование этого типа. В этом примере обработчик событий сообщает о возникновении RowErrorTextNeeded события. Этот отчет поможет вам узнать, когда происходит событие, и может помочь в отладке. Чтобы сообщить о нескольких событиях или о событиях, которые происходят часто, рекомендуется заменить 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 возникает только в том случае, DataGridView если свойство элемента управления DataSource задано или его VirtualMode свойство имеет значение true. RowErrorTextNeeded Обработка события полезна, если требуется определить ошибку для строки в зависимости от ее состояния и содержащихся в ней значений.

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

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

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

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

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

Свойства

ErrorText

Получает или задает текст ошибки для строки.

RowIndex

Получает строку, вызвавшую событие RowErrorTextNeeded.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.

(Унаследовано от Object)

Применяется к

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