DataGridViewDataErrorContexts 枚举

定义

表示进行了数据绑定的 DataGridView 控件在发生数据错误时的状态。

此枚举支持其成员值的按位组合。

public enum class DataGridViewDataErrorContexts
[System.Flags]
public enum DataGridViewDataErrorContexts
[<System.Flags>]
type DataGridViewDataErrorContexts = 
Public Enum DataGridViewDataErrorContexts
继承
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 窗体 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。

适用于

另请参阅