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

欄位

名稱	值	Description
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	在將內容複製到剪貼簿時發生資料錯誤。 此值表示該儲存格值無法轉換為字串。

範例

以下程式碼範例說明此類型的使用方式。 此範例是《 如何處理 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。

另請參閱

• DataGridView
• DataError
• Context