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

Определение

Представляет состояние привязанного к данным элемента управления DataGridView при ошибке.Represents the state of a data-bound DataGridView control when a data error occurred.

Это перечисление имеет атрибут FlagsAttribute, который разрешает побитовое сочетание значений его элементов.

public enum class DataGridViewDataErrorContexts
[System.Flags]
public enum DataGridViewDataErrorContexts
type DataGridViewDataErrorContexts = 
Public Enum DataGridViewDataErrorContexts
Наследование
DataGridViewDataErrorContexts
Атрибуты

Поля

ClipboardContent 16384

Произошла ошибка в данных при копировании содержимого в буфер обмена.A data error occurred when copying content to the Clipboard. Данное значение указывает на то, что не удалось преобразовать значение ячейки в строку.This value indicates that the cell value could not be converted to a string.

Commit 512

Произошла ошибка в данных при фиксации изменений в хранилище данных.A data error occurred when committing changes to the data store. Данное значение указывает на то, что введенные в ячейку данные не удалось зафиксировать в соответствующем хранилище данных.This value indicates that data entered in a cell could not be committed to the underlying data store.

CurrentCellChange 4096

Произошла ошибка в данных при перемещении курсора выделения на другую ячейку.A data error occurred when the selection cursor moved to another cell. Данное значение указывает на то, что пользователь выбрал ячейку при наличии нештатной ситуации в ранее выбранной ячейке.This value indicates that a user selected a cell when the previously selected cell had an error condition.

Display 2

Произошла ошибка в данных при выводе на экран ячейки, которая была заполнена источником данных.A data error occurred when displaying a cell that was populated by a data source. Данное значение указывает на то, что в ячейке не может быть отображено значение из источника данных, или же на то, что преобразования значения из источника данных не происходит.This value indicates that the value from the data source cannot be displayed by the cell, or a mapping that translates the value from the data source to the cell is missing.

Formatting 1

Произошла ошибка в данных при попытке форматирования данных, отправка которых в хранилище данных или загрузка которых из хранилища данных производится в данный момент.A data error occurred when trying to format data that is either being sent to a data store, or being loaded from a data store. Данное значение указывает на то, что не удалось изменить ячейку ввиду неправильности форматирования.This value indicates that a change to a cell failed to format correctly. Необходимо либо исправить новое значение ячейки, либо изменить форматирование ячейки.Either the new cell value needs to be corrected or the cell's formatting needs to change.

InitialValueRestoration 1024

Произошла ошибка в данных при восстановлении предыдущего значения ячейки.A data error occurred when restoring a cell to its previous value. Значение указывает на попытку ячейки отменить правку и сбой при откате к начальному значению.This value indicates that a cell tried to cancel an edit and the rollback to the initial value failed. Такое может происходить, если форматирование ячейки было изменено и оказалось несовместимым с начальным значением.This can occur if the cell formatting changed so that it is incompatible with the initial value.

LeaveControl 2048

Произошла ошибка в данных при потере фокуса элементом управления DataGridView.A data error occurred when the DataGridView lost focus. Значение указывает на то, что после потери фокуса элементом управления DataGridView не удалось зафиксировать пользовательские изменения.This value indicates that the DataGridView could not commit user changes after losing focus.

Parsing 256

Произошла ошибка в данных при анализе новых данных.A data error occurred when parsing new data. Данное значение указывает на то, что элементу управления DataGridView не удалось проанализировать новые данные, введенные пользователем или загруженные из соответствующего хранилища данных.This value indicates that the DataGridView could not parse new data that was entered by the user or loaded from the underlying data store.

PreferredSize 4

Произошла ошибка в данных при вычислении оптимального размера ячейки.A data error occurred when calculating the preferred size of a cell. Данное значение указывает на то, что элементу управления DataGridView не удалось вычислить оптимальную ширину или высоту ячейки при программно реализованном изменении размера столбца или строки.This value indicates that the DataGridView failed to calculate the preferred width or height of a cell when programmatically resizing a column or row. Такое может происходить при неудачной попытке форматирования значения в ячейке.This can occur if the cell failed to format its value.

RowDeletion 8

Произошла ошибка в данных при удалении строки.A data error occurred when deleting a row. Данное значение указывает на то, что соответствующее хранилище данных сгенерировало исключение при удалении строки в привязанном к данным элементе управления DataGridView.This value indicates that the underlying data store threw an exception when a data-bound DataGridView deleted a row.

Scroll 8192

Произошла ошибка в данных при просмотре новой области прокрутки.A data error occurred when scrolling a new region into view. Данное значение указывает на то, что при прокрутке, выполняемой программно или при помощи полосы прокрутки, предпринята попытка просмотра ячейки с ошибками в данных.This value indicates that a cell with data errors scrolled into view programmatically or with the scroll bar.

Примеры

В следующем примере кода показано использование этого типа.The following code example illustrates the use of this type. Этот пример является частью большого примера, который можно использовать в следующих руководствах: Обрабатывайте ошибки, возникающие при вводе данных в элементеуправления Windows Forms DataGridView.This example is part of a larger example available in How to: Handle Errors That Occur During Data Entry in the Windows Forms DataGridView Control.

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

Комментарии

Члены этого перечисления можно комбинировать с помощью побитовой операции или для представления состояния привязанных к DataGridView данным данных при возникновении ошибки данных.Members of this enumeration may be combined using the bitwise OR operation to represent the state of a data-bound DataGridView when a data error occurred. Например, если пользователь вводит недопустимое значение ячейки (например, вводит имя в ячейку, которая ожидает дату), а затем выбирает другую ячейку, DataGridView будет предпринята попытка зафиксировать недопустимое значение ячейки.For example, if a user enters an invalid cell value (such as entering a name in a cell that expects a date) and then selects a different cell, the DataGridView will try to commit the invalid cell value. При сбое DataGridView фиксации DataError вызывает событие, свойство которого Context будет иметь значение Commit и куррентцеллчанже.When the commit fails, the DataGridView will raise a DataError event whose Context property will have a value of Commit and CurrentCellChange.

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

Дополнительно