DataGridViewDataErrorContexts 列舉

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

表示在發生資料錯誤時的資料繫結 DataGridView 控制項之狀態。

此列舉支援其成員值的位元組合。

public enum class DataGridViewDataErrorContexts

[System.Flags]
public enum DataGridViewDataErrorContexts

[<System.Flags>]
type DataGridViewDataErrorContexts = 

Public Enum DataGridViewDataErrorContexts

繼承

Object

ValueType

Enum

DataGridViewDataErrorContexts

屬性

FlagsAttribute

欄位

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	將新的區域捲動到檢視範圍時，發生了資料錯誤。 這個值表示以程式方式或捲軸將含有資料錯誤的儲存格捲動到檢視範圍中。

範例

下列程式碼範例說明如何使用此類型。 此範例是How to： Handle Errors In the data Entry in the 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 嘗試認可不正確儲存格值。 當認可失敗時，會引發 DataError 事件， DataGridView 其 Context 屬性會具有 Commit 和 CurrentCellChange 的值。

另請參閱

• DataGridView
• DataError
• Context