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

フィールド

名前	値	説明
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は、Context プロパティの値が Commit と CurrentCellChange であるDataError イベントを発生させます。

こちらもご覧ください

• DataGridView
• DataError
• Context