DataGridViewDataErrorContexts Перечисление
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Представляет состояние привязанного к данным элемента управления DataGridView при ошибке.
Это перечисление поддерживает побитовую комбинацию значений его членов.
public enum class DataGridViewDataErrorContexts[System.Flags]
public enum DataGridViewDataErrorContexts[<System.Flags>]
type DataGridViewDataErrorContexts = Public Enum DataGridViewDataErrorContexts- Наследование
- Атрибуты
Поля
| Имя | Значение | Описание |
|---|---|---|
| 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.
