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

Определение

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

System.Windows.Forms

Сборка:

System.Windows.Forms.dll

Исходный код:

DataGridViewDataErrorContexts.cs

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

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

public enum class DataGridViewDataErrorContexts

[System.Flags]
public enum DataGridViewDataErrorContexts

[<System.Flags>]
type DataGridViewDataErrorContexts = 

Public Enum DataGridViewDataErrorContexts

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

Object

ValueType

Enum

DataGridViewDataErrorContexts

Атрибуты

FlagsAttribute

Поля

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

Примеры

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

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 попытается зафиксировать недопустимое значение ячейки. При сбое фиксации вызывает DataError событие, DataGridView свойство которого Context будет иметь значение Commit и CurrentCellChange.

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

• DataGridView
• DataError
• Context