DataGridViewDataErrorContexts 列挙体

.NET Framework クラス ライブラリ リファレンス

DataGridViewDataErrorContexts 列挙体

メモ : この列挙体は、.NET Framework version 2.0 で新しく追加されたものです。

データ エラー発生時のデータ連結 DataGridView コントロールの状態を表します。

この列挙体には、メンバ値のビットごとの組み合わせを可能にする FlagsAttribute 属性が含まれています。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

<FlagsAttribute> _
Public Enumeration DataGridViewDataErrorContexts

Visual Basic (使用法)

Dim instance As DataGridViewDataErrorContexts

C#

[FlagsAttribute] 
public enum DataGridViewDataErrorContexts

C++

[FlagsAttribute] 
public enum class DataGridViewDataErrorContexts

J#

/** @attribute FlagsAttribute() */ 
public enum DataGridViewDataErrorContexts

JScript

FlagsAttribute 
public enum DataGridViewDataErrorContexts

メンバ

	メンバ名	説明
	ClipboardContent	内容をクリップボードにコピーするときに、データ エラーが発生しました。この値は、セル値を文字列に変換できなかったことを示します。
	Commit	変更をデータ ストアにコミットするときに、データ エラーが発生しました。この値は、セルに入力されたデータを基になるデータ ソースにコミットできなかったことを示します。
	CurrentCellChange	選択ポインタを別のセルに移動したときに、データ エラーが発生しました。この値は、以前に選択されていたセルがエラー状態のときに、ユーザーがセルを選択したことを示します。
	Display	データ ソースによって値が設定されたセルを表示するときに、データ エラーが発生しました。この値は、データ ソースのデータをセルに表示できないか、データ ソースからの値をセル用に変換するマップが欠落していることを示します。
	Formatting	データ ストアに送信されるデータ、またはデータ ストアから読み込まれるデータの書式を指定するときに、データ エラーが発生しました。この値は、セルの変更で、正しい書式設定ができなかったことを示します。新しいセル値を修正するか、セルの書式設定を変更する必要があります。
	InitialValueRestoration	セルを前の値に戻すときに、データ エラーが発生しました。この値は、セルの編集を取り消して、初期値にロールバックしようとしたときに、失敗したことを示します。これは、セルの書式設定が変更され、初期値と互換性がなくなった場合に発生する可能性があります。
	LeaveControl	DataGridView がフォーカスを失ったときに、データ エラーが発生しました。この値は、DataGridView がフォーカスを失った後、ユーザーの変更をコミットできなかったことを示します。
	Parsing	新しいデータを解析するときに、データ エラーが発生しました。この値は、ユーザーが入力したか、基になるデータ ソースから読み込んだ新しいデータを DataGridView が解析できなかったことを示します。
	PreferredSize	セルの推奨サイズを計算するときに、データ エラーが発生しました。この値は、列または行のサイズをプログラムによって変更するときに、DataGridView がセルの幅や高さの推奨値を計算できなかったことを示します。これは、セルが値の書式を設定できなかった場合に発生する可能性があります。
	RowDeletion	行を削除するときに、データ エラーが発生しました。この値は、データ連結 DataGridView が行を削除したときに、基になるデータ ストアが例外をスローしたことを示します。
	Scroll	新しい領域をビューにスクロールしたときに、データ エラーが発生しました。この値は、データ エラーのあるセルを、プログラムまたはスクロール バーによって、ビューにスクロールしたことを示します。

解説

この列挙体のメンバをビットごとの OR 演算を使用して結合し、データ エラー発生時のデータ連結 DataGridView の状態を表すことができます。たとえば、ユーザーがセルに無効な値を入力し (日付を入力するセルに名前を入力するなど)、他のセルを選択すると、DataGridView は無効なセル値をコミットしようとします。コミットに失敗すると、DataGridView では DataError イベントが発生します。Context プロパティの値は Commit および CurrentCellChange になります。

使用例

この型の使用方法を次のコード例に示します。次の例は「方法 : Windows フォーム DataGridView コントロールでのデータ入力中に発生したエラーを処理する」で取り上げている例の一部です。

Visual Basic

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 Not e.Exception Is
 Nothing AndAlso _
        e.Context = DataGridViewDataErrorContexts.Commit Then

        MessageBox.Show("CustomerID value must be unique.")

    End If

End Sub

C#

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.");
    }
}

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
System.Windows.Forms 名前空間
DataGridView クラス
DataGridView.DataError イベント
DataGridViewDataErrorEventArgs.Context