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	新しい領域をビューにスクロールしたときに、データ エラーが発生しました。 この値は、データ エラーのあるセルを、プログラムまたはスクロール バーによって、ビューにスクロールしたことを示します。

例

次のコード例は、この型の使用方法を示しています。 この例は、「方法: 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 は、プロパティの値が Commit と CurrentCellChange のイベントContextを発生DataErrorさせます。

こちらもご覧ください

• DataGridView
• DataError
• Context