DataGridViewDataErrorContexts Перечисление

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

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

Это перечисление поддерживает побитовую комбинацию значений его членов.

public enum class DataGridViewDataErrorContexts

[System.Flags]
public enum DataGridViewDataErrorContexts

[<System.Flags>]
type DataGridViewDataErrorContexts = 

Public Enum DataGridViewDataErrorContexts

Наследование

Object

ValueType

Enum

DataGridViewDataErrorContexts

Атрибуты

FlagsAttribute

Поля

ClipboardContent	16384	Произошла ошибка в данных при копировании содержимого в буфер обмена. Данное значение указывает на то, что не удалось преобразовать значение ячейки в строку.
Commit	512	Произошла ошибка в данных при фиксации изменений в хранилище данных. Данное значение указывает на то, что введенные в ячейку данные не удалось зафиксировать в соответствующем хранилище данных.
CurrentCellChange	4096	Произошла ошибка в данных при перемещении курсора выделения на другую ячейку. Данное значение указывает на то, что пользователь выбрал ячейку при наличии нештатной ситуации в ранее выбранной ячейке.
Display	2	Произошла ошибка в данных при выводе на экран ячейки, которая была заполнена источником данных. Данное значение указывает на то, что в ячейке не может быть отображено значение из источника данных, или же на то, что преобразования значения из источника данных не происходит.
Formatting	1	Произошла ошибка в данных при попытке форматирования данных, отправка которых в хранилище данных или загрузка которых из хранилища данных производится в данный момент. Данное значение указывает на то, что не удалось изменить ячейку ввиду неправильности форматирования. Необходимо либо исправить новое значение ячейки, либо изменить форматирование ячейки.
InitialValueRestoration	1024	Произошла ошибка в данных при восстановлении предыдущего значения ячейки. Значение указывает на попытку ячейки отменить правку и сбой при откате к начальному значению. Такое может происходить, если форматирование ячейки было изменено и оказалось несовместимым с начальным значением.
LeaveControl	2048	Произошла ошибка в данных при потере фокуса элементом управления DataGridView. Значение указывает на то, что после потери фокуса элементом управления DataGridView не удалось зафиксировать пользовательские изменения.
Parsing	256	Произошла ошибка в данных при анализе новых данных. Данное значение указывает на то, что элементу управления DataGridView не удалось проанализировать новые данные, введенные пользователем или загруженные из соответствующего хранилища данных.
PreferredSize	4	Произошла ошибка в данных при вычислении оптимального размера ячейки. Данное значение указывает на то, что элементу управления DataGridView не удалось вычислить оптимальную ширину или высоту ячейки при программно реализованном изменении размера столбца или строки. Такое может происходить при неудачной попытке форматирования значения в ячейке.
RowDeletion	8	Произошла ошибка в данных при удалении строки. Данное значение указывает на то, что соответствующее хранилище данных сгенерировало исключение при удалении строки в привязанном к данным элементе управления DataGridView.
Scroll	8192	Произошла ошибка в данных при просмотре новой области прокрутки. Данное значение указывает на то, что при прокрутке, выполняемой программно или при помощи полосы прокрутки, предпринята попытка просмотра ячейки с ошибками в данных.

Примеры

В следующем примере кода показано использование этого типа. Этот пример является частью более крупного примера, доступного в разделе Практическое руководство. Обработка ошибок, возникающих во время ввода данных в элементе управления Windows Forms DataGridView.

private void dataGridView1_DataError(object sender,
    DataGridViewDataErrorEventArgs e)
{
    // If the data source raises an exception when a cell value is 
    // commited, display an error message.
    if (e.Exception != null &&
        e.Context == DataGridViewDataErrorContexts.Commit)
    {
        MessageBox.Show("CustomerID value must be unique.");
    }
}

Private Sub dataGridView1_DataError(ByVal sender As Object, _
    ByVal e As DataGridViewDataErrorEventArgs) _
    Handles dataGridView1.DataError

    ' If the data source raises an exception when a cell value is 
    ' commited, display an error message.
    If e.Exception IsNot Nothing AndAlso _
        e.Context = DataGridViewDataErrorContexts.Commit Then

        MessageBox.Show("CustomerID value must be unique.")

    End If

End Sub

Комментарии

Члены этого перечисления можно объединить с помощью побитовой операции OR для представления состояния привязанного DataGridView к данным при возникновении ошибки данных. Например, если пользователь вводит недопустимое значение ячейки (например, вводит имя в ячейке, которая ожидает дату), а затем выбирает другую ячейку, DataGridView объект попытается зафиксировать недопустимое значение ячейки. При сбое фиксации DataGridView вызывает DataError событие, свойство которого Context будет иметь значение Commit и CurrentCellChange.

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

• DataGridView
• DataError
• Context